VS Code 接入 AMD Vivado 2026.1 AI 助手：从 VSIX 到 MCP 实战

本文记录在 Windows 上安装 AMD Vivado AI Extension，并让 AI Agent 连接 Vivado 的完整过程。实测环境为 Vivado 2026.1、VS Code 1.106.2 和 vivado-ai-extension-2026.9.1.vsix。

一、为什么要给 Vivado 接入 AI？

FPGA 开发中，大量时间并不只花在编写 RTL 上。创建工程、添加文件、配置约束、启动综合、等待实现、查看时序和定位日志错误，往往需要在 Vivado GUI、Tcl Console、代码编辑器和工程目录之间反复切换。

AMD Ross Agentic AI Assistant 的思路，是通过 MCP（Model Context Protocol）把 AI Agent 和真实的 Vivado 会话连接起来：

VS Code Copilot / Claude Code / Cline
                 │ MCP
                 ▼
        Vivado MCP Server
                 │ Tcl
                 ▼
            Vivado 2026.1

连接完成后，AI 可以启动 Vivado 会话、执行 Tcl、查看日志、跟踪综合和实现进度，并将多步操作显示在 Tasks 面板中。VS Code 扩展还提供 Vivado Terminal、会话管理和工具调用面板。

本文的重点不是简单安装一个 VSIX，而是把"扩展已安装但 AI 看不到 Vivado 工具"这一常见问题完整解决。

二、实测环境

项目	实测值
操作系统	Windows 11，64 位，Build 26100
VS Code	1.106.2
Vivado	2026.1，64 位
Vivado AI Extension	2026.9.1
Vivado 路径	D:\DevTools\Vivado2026.1\2026.1\Vivado\bin\vivado.bat
AI 客户端	Claude Code / Cline / 支持 MCP 的 VS Code Chat

注意：Vitis 和 Vivado 是安装目录中两个不同的工具目录。Vitis\bin 下主要是 vitis.bat、v++ 和 vitis-run，而 MCP 服务端需要的 Vivado 启动器位于：

D:\DevTools\Vivado2026.1\2026.1\Vivado\bin\vivado.bat

配置路径时不要误填成 Vitis\bin。

三、三份发布文件分别做什么？

下载目录中通常有三个文件：

文件	用途
vivado-ai-extension-2026.9.1.vsix	VS Code/Cursor 扩展，包含图形界面、Vivado Terminal、Tasks、Skills 和 MCP 服务端
vivado-mcp-server-windows-amd64-2026.9.1.exe	Windows 独立 MCP 服务端，供 Claude Code、Codex、Copilot CLI 等使用
vivado-mcp-server-linux-amd64-2026.9.1	Linux 独立 MCP 服务端，额外支持 LSF、SSH 和虚拟 GUI

VSIX 内部已经带有两个平台的服务端。因此，在 VS Code 中使用 VSIX 时不需要再次配置独立的 Windows EXE。

四、安装并启用扩展

可以在 VS Code 扩展面板中选择"从 VSIX 安装"，也可以直接在 PowerShell 中执行：

code --install-extension "F:\FPGA\AMD-ross-agentic-ai\vivado-ai-extension-2026.9.1.vsix"

安装成功后在扩展搜索框中输入：

@installed vivado

可以看到 AMD 发布的 Vivado AI Extension 2026.9.1。

安装完成后建议执行一次：

Developer: Reload Window

扩展会启动并自动注册 Vivado MCP Server。底部状态栏最终应出现 MCP: Running。

五、配置 Vivado 安装路径

打开命令面板，执行：

Preferences: Open User Settings (UI)

搜索：

vivadoAI.vivadoPath

填写实际的 vivado.bat 路径：

D:\DevTools\Vivado2026.1\2026.1\Vivado\bin\vivado.bat

如果需要使用 JSON 配置，对应写法是：

{
  "vivadoAI.vivadoPath": "D:\\DevTools\\Vivado2026.1\\2026.1\\Vivado\\bin\\vivado.bat",
  "vivadoAI.defaultWorkingDir": "F:\\FPGA",
  "vivadoAI.defaultGuiMode": false,
  "vivadoAI.enableSkills": true,
  "vivadoAI.autoRegisterMcp": true
}

这里的 defaultGuiMode 设置为 false，表示默认使用 Tcl 模式启动。Tcl 模式启动更快，也适合综合、实现和脚本化操作；需要查看 IP Integrator、原理图或 GUI 时再执行 start_gui。

还要注意工作区必须是可信目录。扩展会启动本地进程并执行 Vivado，因此未受信任的工作区无法正常使用相关能力。

六、先验证扩展本身

打开一个 FPGA 工程目录，然后在命令面板中依次执行：

Vivado AI: Show Connection Status
Vivado AI: Start New Session

启动类型选择 general。成功后可以观察到：

1. AMD 侧边栏出现活动 Session；
2. Vivado Terminal 显示 Connected；
3. 终端中出现 Vivado Tcl 提示符；
4. 左下状态栏显示 Vivado: Connected；
5. 右下状态栏显示 MCP: Running。

这一步非常关键。如果只是 VSIX 安装成功，但路径错误，状态栏不会出现有效连接，AI 也无法真正控制 Vivado。

七、把 MCP 工具接入 AI Chat

如果你的 VS Code 已经安装 GitHub Copilot Chat，可以在聊天面板底部的"Configure Tools"中启用 vivado-mcp-server，然后切换到 Agent 模式。

如果使用 Claude Code，可以直接注册扩展自带的 Windows MCP 服务端：

claude mcp add vivado-mcp --scope user --transport stdio --env "VIVADO_PATH=D:\DevTools\Vivado2026.1\2026.1\Vivado\bin\vivado.bat" -- "C:\Users\Administrator\.vscode\extensions\amd.vivado-ai-extension-2026.9.1\bin\vivado-mcp-server-windows-amd64-2026.9.1.exe" --stdio-bridge

验证：

claude mcp list

随后重新加载 VS Code，新建 AI Chat 会话，输入：

列出当前可用的 Vivado MCP 工具

实测结果 ：Claude Code 识别并调用了 Vivado-mcp [vivado_list_sessions]，返回两个活动的 Vivado 会话。截图同时显示 MCP: Running 和下方 Vivado Terminal 的 Connected，说明自然语言请求已经通过 MCP 到达真实 Vivado 进程。

如果使用 Cline，可以在 MCP Servers → Installed → Configure MCP Servers 中加入：

{
  "mcpServers": {
    "vivado": {
      "type": "stdio",
      "command": "C:\\Users\\Administrator\\.vscode\\extensions\\amd.vivado-ai-extension-2026.9.1\\bin\\vivado-mcp-server-windows-amd64-2026.9.1.exe",
      "args": ["--stdio-bridge"],
      "env": {
        "VIVADO_PATH": "D:\\DevTools\\Vivado2026.1\\2026.1\\Vivado\\bin\\vivado.bat"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

推荐使用 --stdio-bridge。它会连接共享的后台 MCP 服务，因此客户端重启时，Vivado 会话更容易保留下来。

访问独立文档搜索 vivado_doc_search

vivado_doc_search 并不属于 vivado-mcp，而是由独立的 amd-doc-search MCP 服务提供。VSIX 会向支持 VS Code MCP API 的客户端自动注册它；使用 Claude Code 时，可以在项目根目录增加如下 .mcp.json：

{
  "mcpServers": {
    "amd-doc-search": {
      "type": "http",
      "url": "https://ross.amd.com/mcp/doc-search"
    }
  }
}

首次打开项目时，Claude Code 会要求批准新的项目级 MCP 服务。批准后输入 /mcp，可以看到 amd-doc-search · connected · 1 tool，同时原有 vivado-mcp 仍显示连接成功，说明"会话控制"和"文档检索"是两个独立服务。

本次实测完成了三步：

• initialize 返回 HTTP 200，服务端为 AMD Doc Search v0.11.6；
• tools/list 返回 vivado_doc_search；
• 调用参数 query="UG903 set_false_path", limit=3, alpha=0.5 成功返回 AMD 官方文档结果。

返回的官方来源为 UG903：Vivado Design Suite User Guide: Using Constraints，版本 2026.1。文档同时说明，异步时钟域之间通常应使用 set_clock_groups，set_false_path 更适合确认无需时序分析的非功能路径。

八、实际使用示例

连接成功后，可以尝试以下提示词：

在 F:\FPGA\led_flash 启动一个 general Vivado 会话，
读取当前工程信息，并告诉我 Vivado 版本。

检查当前工程综合中的 Error 和 Critical Warning，
按严重程度整理，并给出修复建议。

列出实现后最差的 10 条时序路径，
说明失败原因和相关时钟约束。

启动综合，完成后读取时序和资源利用率报告。

AI 最终调用的仍是 Vivado 的标准 Tcl 命令，因此终端、vivado.log 和历史记录中都能看到完整操作过程，便于复核。

九、常见问题排查

1. 扩展已安装，但没有 Vivado 工具

检查底部是否显示 MCP: Running，然后执行：

Vivado AI: Reconnect to MCP Server

必要时执行 Vivado AI: Kill All MCP Servers & Restart。

2. 提示找不到 Vivado

核对 vivadoAI.vivadoPath。路径必须指向 Vivado\bin\vivado.bat，而不是 Vitis\bin。

3. MCP 显示运行，但 Session 启动失败

检查工作目录是否存在、是否有写权限，以及 Vivado License 是否正常。可以先用下面的命令确认 Vivado 安装本身可用：

& "D:\DevTools\Vivado2026.1\2026.1\Vivado\bin\vivado.bat" -version

正常输出应包含：

vivado v2026.1 (64-bit)

4. Claude Code 中看不到工具

执行 claude mcp list 检查服务端是否存在，然后重新加载 VS Code 并创建新的 Claude Code 会话。

5. 不要直接公开完整的 settings.json

个人设置文件中可能包含模型服务的 Token、内部路径或其他敏感配置。截图时建议使用设置搜索界面，只显示 Vivado AI 相关项目，而不要直接展示整个 JSON 文件。

十、安全与资源建议

• 扩展会启动本地 Vivado 和 MCP 进程，应在可信工作区使用。
• 独立 MCP 服务端建议从 AMD 官方发布渠道获取，并核对发布页提供的哈希。
• vivado_doc_search 是独立文档服务。默认会访问 AMD 文档搜索服务；离线环境可以在扩展设置中关闭 vivadoAI.registerDocSearch。
• 长时间的综合和实现任务应通过 vivado_status 和 vivado_log_messages 跟踪，不要反复重启 Vivado。
• 公开截图前，检查路径、Session ID、日志和设置文件中是否包含内部工程名、许可证服务器或访问令牌。

十一、总结

这次配置可以概括为四步：

安装 VSIX
   ↓
配置 Vivado\bin\vivado.bat
   ↓
确认 MCP Running + Vivado Connected
   ↓
在 AI Chat 中启用或注册 vivado-mcp

AMD Vivado AI Extension 的价值不只是在 VS Code 中增加一个聊天窗口，而是通过 MCP 把自然语言请求、Tcl 命令、日志分析和工程状态连接成一条可追踪的工作流。

对于已经安装 Vivado 2026.1 的 Windows 用户，使用 VSIX 是配置成本最低的方案。只要明确 Vivado 与 Vitis 的路径区别，并确认 MCP 和 Vivado Session 都处于连接状态，就可以开始让 AI 参与实际的 FPGA 工程操作。

---

标签： FPGA、Vivado、VS Code、MCP、AI Agent、AMD