**让 Claude Code、Cursor, Codex 等 AI Agent 安全驱动本地 Xilinx Vivado. **

32 个 MCP 도구覆盖会话、综合、实现、时序、CDC、XDC、IP、波形与烧录。 可保存结构化时序结果、比较两次测量、离线查询 VCD 中的未知值与握手事件;通用 Vivado 操作由 run_tcl 承载.

본项目控制的是你本机安装的 Vivado,不是云端综合服务。 命令在当前用户权限下执行；工具说明和诊断建议以中文为主。

영어: 32개의 도구, 구조화된 타이밍 증거 및 기준선 비교, 경계 오프라인 VCD 쿼리, 11개의 워크플로우 프롬프트, 5개의 재사용 가능한 스킬을 갖춘 로컬 Vivado MCP 서버입니다.

导航：快速开始 · 实际调试场景 · 工具设计 · 工作流 프롬프트 · 工具列表 · 调试指南与 기술 · CLI · 反馈

环境要求

• Python ≥ 3.10, Windows / Linux
• Xilinx Vivado:반드시 安装在运行 vivado-mcp 的本机
• MCP Python SDK 2.x:唯一직접 运行时依赖,pip 会自动安装

快速开始

1. 安装

多 Python 环境下,请让 MCP 客户端使用同一个 Python 解释器;必要时把下方配置中的 python 换成该解释器的绝对路径。

2. 先运行环境诊断

vivado-mcp

让 Claude Code、Cursor、Codex 等 AI Agent 安全驱动本地 Xilinx Vivado。

32 个 MCP 工具覆盖会话、综合、实现、时序、CDC、XDC、IP、波形与烧录。可保存结构化时序结果、比较两次测量、离线查询 VCD 中的未知值与握手事件；通用 Vivado 操作由 run_tcl 承载。

本项目控制的是你本机安装的 Vivado，不是云端综合服务。命令在当前用户权限下执行；工具说明和诊断建议以中文为主。

English: A local Vivado MCP server with 32 tools, structured timing evidence and baseline comparison, bounded offline VCD queries, 11 workflow prompts, and 5 reusable skills.

导航：快速开始 · 实际调试场景 · 工具设计 · 工作流 Prompts · 工具列表 · 调试指南与 Skills · CLI · 反馈

环境要求

• Python ≥ 3.10，Windows / Linux
• Xilinx Vivado：必须安装在运行 vivado-mcp 的本机
• MCP Python SDK 2.x：唯一直接运行时依赖，pip 会自动安装

快速开始

1. 安装

python -m pip install vivado-mcp

多 Python 环境下，请让 MCP 客户端使用同一个 Python 解释器；必要时把下方配置中的 python 换成该解释器的绝对路径。

2. 先运行环境诊断

vivado-mcp doctor

doctor 默认完全只读，检查 Vivado 路径、init Tcl 注入、9999 端口协议、Claude Code/Codex 配置，并给出精确的修复计划。CI 或 Agent 可使用结构化输出：

vivado-mcp doctor --json

3. 注入 Vivado（一次性）

vivado-mcp install

这会修改你 Vivado 的 Vivado_init.tcl，让以后启动 GUI 时自动开启 TCP server（绑定 install 指定的单一端口，默认 9999；被占即退出，不会滑动到其他端口）。原文件会备份，vivado-mcp uninstall 可恢复。

如果 Vivado 装在受保护目录（如 C:\Program Files\），用管理员身份运行命令即可。

也可以让 doctor 执行安全修复：

vivado-mcp doctor --fix --client all

--fix 才会写文件：复用幂等的 Vivado 注入，并在备份后原子更新选定客户端配置；不会删除第三方注入、终止占用端口的进程或自动升级软件。

4. 配置 MCP 客户端

doctor --fix 可自动配置 Claude Code 和 Codex。手动配置时，Claude Code 使用 ~/.claude.json，Cursor 使用项目级 .cursor/mcp.json 或用户级 ~/.cursor/mcp.json；两者都在 mcpServers 中加入：

"vivado": {
  "command": "python",
  "args": ["-m", "vivado_mcp"],
  "env": {
    "VIVADO_PATH": "D:/Xilinx/Vivado/2019.1/bin/vivado.bat"
  },
  "type": "stdio"
}

Codex 使用 ~/.codex/config.toml：

[mcp_servers.vivado]
command = "python"
args = ["-m", "vivado_mcp"]

[mcp_servers.vivado.env]