For Vivado

面向 AI 的 Vivado MCP 工作台。
本项目采用 MCP-first 设计，不提供自研桌面 GUI；Vivado 相关操作必须在真实 Vivado GUI 中执行，并在关键步骤切到对应可视上下文。

当前状态

• 版本：v2.0.0
• PM 结论：v2 已整体完成
• 当前发布范围：
  • Windows 主线使用场景
  • v2 public workflow 方法面
  • phase-2 核心跨域闭环
  • phase-3 proof / contract / semantic / referent / public schema 收口链条

适用场景

• 由 AI 调用 MCP / workflow 方法，驱动 Vivado 设计、验证与调试主流程
• 自动发现本机 Vivado 版本并完成 workspace 级绑定
• 设计 IP、设计 Block Design、运行 simulation
• 跨 simulation / timing / ILA / design follow-up 的自动回流与复验
• 在 Vivado GUI 中显示关键步骤对应的上下文

目录说明

• docs/USER_INSTALL_AND_USAGE.md 用户安装到使用说明
• docs/AI_INSTALL_AND_USAGE.md 面向 AI / Agent 的接入说明
• docs/AI_MCP_RELEASE_INSTALL.md 面向 AI / MCP 客户端的发行安装说明
• scripts/install_mcp_for_ai.ps1 Windows 一键安装脚本
• docs/mcp/V2_PUBLIC_API.md v2 public MCP 方法清单
• docs/pm/V2_FINAL_COMPLETION_MEMO.md v2 最终收口 memo
• docs/V2_RELEASE_PACKAGE.md v2 发布包说明与发布清单

快速开始

1. 安装 Python 3.11+
2. 安装 Vivado，并确保版本不低于 2018.3
3. 执行：

cd D:\ai_playgraund\vivado_mcp
powershell -ExecutionPolicy Bypass -File .\scripts\install_mcp_for_ai.ps1

4. 按 docs/USER_INSTALL_AND_USAGE.md 或 docs/AI_INSTALL_AND_USAGE.md 开始使用

当前入口

当前发布版暴露的是 Python 进程内 MCP 风格入口：

• server.py
• v2_public_server.py

核心类：

• fpga_mcp.FpgaMcpServer
• fpga_mcp.FpgaMcpV2PublicServer

说明：

• 当前仓库提供的是“方法注册 + 协议返回壳 + orchestration 接线”的 Python 包入口
• 不是一个独立的 stdio / HTTP 传输层服务
• 若要接入外部 AI 宿主，可在宿主中直接导入 FpgaMcpV2PublicServer 并调用 list_methods() / invoke()

v2 Public 方法

• create_workflow
• get_workflow
• list_workflows
• design_block_design
• design_ip
• run_simulation
• confirm_workflow
• reject_workflow
• cancel_workflow
• submit_workflow_input
• get_workflow_events