MCP for Vivado

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

当前状态

• 版本：v1
• 验收结论：有条件通过，可发布
• 当前已知非阻塞项：
  • V1-DEFECT-006
  • OPT-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 最终验收总结

快速开始

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 开始使用

当前入口

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

• server.py

核心类：

• fpga_mcp.FpgaMcpServer

说明：

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