{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kubc8dzk9wzz","handle":"vivado-mcp","url":"https://wellknown.network/agents/vivado-mcp","links":{"self":"https://wellknown.network/agents/vivado-mcp/record.json","html":"https://wellknown.network/agents/vivado-mcp","markdown":"https://wellknown.network/agents/vivado-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vivado-mcp","status":"https://wellknown.network/api/v1/agents/vivado-mcp/status","claim":"https://wellknown.network/agents/vivado-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vivado-mcp/claim.json","badge":"https://wellknown.network/agents/vivado-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vivado-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vivado-mcp","summary":"Vivado MCP Server — AI 驱动的 FPGA 开发助手，支持 GUI 可视化 / 子进程无头双模式，自动诊断 CRITICAL WARNING","description":"# vivado-mcp\n\n[![PyPI version](https://img.shields.io/pypi/v/vivado-mcp)](https://pypi.org/project/vivado-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/vivado-mcp)](https://pypi.org/project/vivado-mcp/)\n[![License](https://img.shields.io/github/license/mapleleavessssssss-wq/vivado-mcp)](LICENSE)\n[![CI](https://github.com/mapleleavessssssss-wq/vivado-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/mapleleavessssssss-wq/vivado-mcp/actions/workflows/ci.yml)\n\n**让 Claude Code、Cursor、Codex 等 AI Agent 安全驱动本地 Xilinx Vivado。**\n\n30 个精选 MCP 工具覆盖会话、综合、实现、时序、XDC、IP、波形与烧录；其余 Vivado 能力由通用 `run_tcl` 承载。相比把每条 Tcl 命令包装成工具，这种设计占用更少上下文，也更容易跨 Vivado 版本维护。\n\n| 30 个精选工具 | 8 个证据驱动工作流 | 2 个实时 Resources | GUI / Tcl / attach 三种会话 |\n|---:|---:|---:|---:|\n\n> 本项目控制的是**你本机安装的 Vivado**，不是云端综合服务。命令在当前用户权限下执行；工具说明和诊断建议以中文为主。\n>\n> **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.\n\n**导航**：[快速开始](#快速开始) · [为什么是 30 个工具](#设计哲学--为什么是-30-个工具而不是-500-个) · [工作流 Prompts](#工作流-prompts) · [工具列表](#工具列表) · [会话模式](#会话模式) · [架构](#架构) · [CLI](#cli-参考) · [反馈](#反馈与-bug-提交)\n\n## 环境要求\n\n- **Python ≥ 3.10**，Windows / Linux\n- **Xilinx Vivado**：必须安装在运行 vivado-mcp 的本机\n- **MCP Python SDK 2.x**：唯一直接运行时依赖，`pip` 会自动安装\n\n| Vivado 版本 | 支持等级 | 验证范围 |\n|---|---|---|\n| 2019.1 | **主要支持基线** | 作者长期实测 GUI / Tcl / attach 与完整 FPGA 流程 |\n| 2018.3 | **部分路径验证** | 社区贡献者验证 IPDEF-only IP 元数据（[PR #1](https://github.com/mapleleavessssssss-wq/vivado-mcp/pull/1)） |\n| 2022.2 | **社区现场验证** | Windows 10 GUI/XSim 问题现场（[Issue #2](https://github.com/mapleleavessssssss-wq/vivado-mcp/issues/2)），不代表完整回归 |\n| 其他版本 | **实验性兼容** | 协议层为纯 Tcl，但未持续做真机矩阵；请先跑下方冒烟验证 |\n\n## 快速开始\n\n### 1. 安装\n\n```bash\npython -m pip install vivado-mcp\n```\n\n多 Python 环境下，请让 MCP 客户端使用同一个 Python 解释器；必要时把下方配置中的 `python` 换成该解释器的绝对路径。\n\n### 2. 先运行环境诊断\n\n```bash\nvivado-mcp doctor\n```\n\n`doctor` 默认完全只读，检查 Vivado 路径、init Tcl 注入、9999 端口协议、Cl…","publisher":{"name":"NJ","url":null},"homepage":"https://github.com/mapleleavessssssss-wq/vivado-mcp","repository":"https://github.com/mapleleavessssssss-wq/vivado-mcp/blob/main/CHANGELOG.md","version":"0.3.25","license":null,"protocols":["mcp"],"tags":["claude","eda","fpga","mcp","model-context-protocol","tcl","verilog","vivado","xilinx"],"pricing":null,"endpoints":[{"url":"pypi:vivado-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.779,"provenance":"derived"}],"categories":["ai","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vivado-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:14.655Z","publishedAt":"2026-08-09T08:35:36.175286Z","latestVersion":"0.3.25"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vivado-mcp","url":"https://pypi.org/project/vivado-mcp/","firstSeenAt":"2026-09-10T15:23:44.349Z","fetchedAt":"2026-09-10T15:23:44.349Z","normalizedAt":"2026-09-10T15:23:44.349Z"}]},"firstSeenAt":"2026-09-10T15:23:44.349Z","updatedAt":"2026-09-10T15:25:14.655Z"}