vivado-mcp

# vivado-mcp [](https://pypi.org/project/vivado-mcp/) [](https://pypi.org/project/vivado-mcp/) [](LICENSE) [](https://github.com/mapleleavessssssss-wq/vivado-mcp/actions/workflows/ci.yml) **让 Claude Code、Cursor、Codex 等 AI Agent 安全驱动本地 Xilinx Vivado。** 30 个精选 MCP 工具覆盖会话、综合、实现、时序、XDC、IP、波形与烧录；其余 Vivado 能力由通用 `run_tcl` 承载。相比把每条 Tcl 命令包装成工具，这种设计占用更少上下文，也更容易跨 Vivado 版本维护。 | 30 个精选工具 | 8 个证据驱动工作流 | 2 个实时 Resources | GUI / Tcl / attach 三种会话 | |---:|---:|---:|---:| > 本项目控制的是**你本机安装的 Vivado**，不是云端综合服务。命令在当前用户权限下执行；工具说明和诊断建议以中文为主。 > > **English:** A lean MCP server for driving local Xilinx Vivado from AI agents. It provides 30 curated tools, 8 evidence-gated workflow prompts, GUI/headless/attach sessions, and raw Tcl escape hatches. **导航**：[快速开始](#快速开始) · [为什么是 30 个工具](#设计哲学--为什么是-30-个工具而不是-500-个) · [工作流 Prompts](#工作流-prompts) · [工具列表](#工具列表) · [会话模式](#会话模式) · [架构](#架构) · [CLI](#cli-参考) · [反馈](#反馈与-bug-提交) ## 环境要求 - **Python ≥ 3.10**，Windows / Linux - **Xilinx Vivado**：必须安装在运行 vivado-mcp 的本机 - **MCP Python SDK 2.x**：唯一直接运行时依赖，`pip` 会自动安装 | Vivado 版本 | 支持等级 | 验证范围 | |---|---|---| | 2019.1 | **主要支持基线** | 作者长期实测 GUI / Tcl / attach 与完整 FPGA 流程 | | 2018.3 | **部分路径验证** | 社区贡献者验证 IPDEF-only IP 元数据（[PR #1](https://github.com/mapleleavessssssss-wq/vivado-mcp/pull/1)） | | 2022.2 | **社区现场验证** | Windows 10 GUI/XSim 问题现场（[Issue #2](https://github.com/mapleleavessssssss-wq/vivado-mcp/issues/2)），不代表完整回归 | | 其他版本 | **实验性兼容** | 协议层为纯 Tcl，但未持续做真机矩阵；请先跑下方冒烟验证 | ## 快速开始 ### 1. 安装 ```bash python -m pip install vivado-mcp ``` 多 Python 环境下，请让 MCP 客户端使用同一个 Python 解释器；必要时把下方配置中的 `python` 换成该解释器的绝对路径。 ### 2. 先运行环境诊断 ```bash vivado-mcp doctor ``` `doctor` 默认完全只读，检查 Vivado 路径、init Tcl 注入、9999 端口协议、Cl…