README.md
An AI-centric MCP workbench for automating Xilinx Vivado workflows.
MCP for Vivado
面向 AI 的 Vivado MCP 工作台。
本项目采用 MCP-first 设计，不提供自研桌面 GUI；Vivado 相关操作必须在真实 Vivado GUI 中执行，并在关键步骤切到对应可视上下文。
当前状态
- 版本：
v1 - 验收结论：有条件通过，可发布
- 当前已知非阻塞项：
V1-DEFECT-006OPT-001
适用场景
- 由 AI 调用 MCP 方法，驱动 Vivado 工程主流程
- 自动发现本机 Vivado 版本并完成 workspace 级绑定
- 打开工程、添加源码/约束、运行综合/实现、读取时序与资源摘要
- 在 Vivado GUI 中显示关键步骤对应的上下文
目录说明
- docs/USER_INSTALL_AND_USAGE.md 用户安装到使用说明
- docs/AI_INSTALL_AND_USAGE.md 面向 AI / Agent 的接入说明
- scripts/install_mcp_for_ai.ps1 Windows 一键安装脚本
- docs/mcp/V1_MCP_METHODS.md v1 MCP 方法清单
- docs/pm/V1_ACCEPTANCE_SUMMARY.md 最终验收总结
快速开始
- 安装 Python
3.11+ - 安装 Vivado，并确保版本不低于
2018.3 - 执行：
cd D:\ai_playgraund\vivado_mcp
powershell -ExecutionPolicy Bypass -File .\scripts\install_mcp_for_ai.ps1
当前入口
当前 v1 暴露的是 Python 进程内 MCP 风格入口：
核心类：
fpga_mcp.FpgaMcpServer
说明：
- 当前仓库提供的是“方法注册 + 协议返回壳 + orchestration 接线”的 v1 入口
- 不是一个独立的 stdio / HTTP 传输层服务
- 若要接入外部 AI 宿主，可在宿主中直接导入
FpgaMcpServer并调用list_methods()/invoke()
Tools (4)
manage_projectOpen Vivado projects and manage workspace bindings.modify_designAdd source files or constraints to the current Vivado project.run_workflowExecute synthesis or implementation processes in Vivado.get_summaryRetrieve timing analysis and resource utilization summaries.Configuration
claude_desktop_config.json
{"mcpServers": {"vivado": {"command": "python", "args": ["path/to/server.py"]}}}Try it
→Open the Vivado project located at D:/projects/fpga_design and bind it to the current workspace.
→Add the new constraints file constraints.xdc to the active project.
→Run the synthesis process and report any timing violations found.
→Provide a summary of the resource utilization for the current implementation.