What it does
Native MCP server for controlling AMD/Xilinx Vivado on Windows and Linux via persistent Tcl.
- Connects パソコンで動く
- Account or key No key needed
- Category 開発者ツール
一緒に使える
この種の作業を AI に教える Skill。これと一緒に使えます
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 3/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 3/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Vivado MCP Native をインストールして。https://mcp.popnx.com/i/arthurzxy-vivado-mcp-native.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Vivado MCP Native を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vivado-native": { "command": "uvx", "args": [ "vivado-mcp-native" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vivado MCP Native のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "vivado-native": { "command": "uvx", "args": [ "vivado-mcp-native" ] } } }Claude を終了してもう一度開く
試してみる
Vivado MCP Native を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Vivado MCP Native を使っていると言うか、回答に Vivado MCP Native のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
VIVADO_PATHVivado ランチャー、bin ディレクトリ、またはバージョンディレクトリへのオプションのパス。英語の原文を見る
Optional path to a Vivado launcher, bin directory, or version directory.VIVADO_MCP_OUTPUT_ENCODINGVivado Tcl コンソール出力の任意のエンコーディング(utf-8 や gbk など)。英語の原文を見る
Optional Vivado Tcl console output encoding, such as utf-8 or gbk.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Vivado MCP Native につなげません
Vivado MCP Native はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Vivado MCP Native につなげるアプリを使う
- 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Vivado MCP Native を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user vivado-native -- uvx vivado-mcp-native 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vivado MCP Native のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user vivado-native -- uvx vivado-mcp-nativeClaude Code で /mcp と入力
Vivado MCP Native が一覧にあり、接続済みと表示されれば OK です
試してみる
Vivado MCP Native を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Vivado MCP Native を使っていると言うか、回答に Vivado MCP Native のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
VIVADO_PATHVivado ランチャー、bin ディレクトリ、またはバージョンディレクトリへのオプションのパス。英語の原文を見る
Optional path to a Vivado launcher, bin directory, or version directory.VIVADO_MCP_OUTPUT_ENCODINGVivado Tcl コンソール出力の任意のエンコーディング(utf-8 や gbk など)。英語の原文を見る
Optional Vivado Tcl console output encoding, such as utf-8 or gbk.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Vivado MCP Native を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vivado-native": { "command": "uvx", "args": [ "vivado-mcp-native" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vivado MCP Native のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
Vivado MCP Native を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Vivado MCP Native を使っていると言うか、回答に Vivado MCP Native のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
VIVADO_PATHVivado ランチャー、bin ディレクトリ、またはバージョンディレクトリへのオプションのパス。英語の原文を見る
Optional path to a Vivado launcher, bin directory, or version directory.VIVADO_MCP_OUTPUT_ENCODINGVivado Tcl コンソール出力の任意のエンコーディング(utf-8 や gbk など)。英語の原文を見る
Optional Vivado Tcl console output encoding, such as utf-8 or gbk.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Vivado MCP Native を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "vivado-native": { "type": "stdio", "command": "uvx", "args": [ "vivado-mcp-native" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vivado MCP Native のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
Vivado MCP Native を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Vivado MCP Native を使っていると言うか、回答に Vivado MCP Native のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
VIVADO_PATHVivado ランチャー、bin ディレクトリ、またはバージョンディレクトリへのオプションのパス。英語の原文を見る
Optional path to a Vivado launcher, bin directory, or version directory.VIVADO_MCP_OUTPUT_ENCODINGVivado Tcl コンソール出力の任意のエンコーディング(utf-8 や gbk など)。英語の原文を見る
Optional Vivado Tcl console output encoding, such as utf-8 or gbk.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user vivado-native -- uvx vivado-mcp-nativeClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"vivado-native": {
"command": "uvx",
"args": [
"vivado-mcp-native"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"vivado-native": {
"command": "uvx",
"args": [
"vivado-mcp-native"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"vivado-native": {
"type": "stdio",
"command": "uvx",
"args": [
"vivado-mcp-native"
]
}
}
}自分で入力する値
VIVADO_PATHenvVivado ランチャー、bin ディレクトリ、またはバージョンディレクトリへのオプションのパス。英語の原文を見る
Optional path to a Vivado launcher, bin directory, or version directory.VIVADO_MCP_OUTPUT_ENCODINGenvVivado Tcl コンソール出力の任意のエンコーディング(utf-8 や gbk など)。英語の原文を見る
Optional Vivado Tcl console output encoding, such as utf-8 or gbk.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月18日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Arthurzxy で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:4 か月前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に vivado-mcp-native@0.2.1 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/arthurzxy-vivado-mcp-native)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの6083件のうち0%よりスターが多い
- このカテゴリのほかの6083件のうち22%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの6083件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Vivado MCP Nativeは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は4 か月前、最新バージョン(0.2.1)がレジストリに届いたのは4 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは?
同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| これ Vivado MCP Native | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
简体中文 | English
Vivado MCP Native
让 Claude、Cursor、Cline、Cherry Studio 等兼容 MCP 的 AI 客户端
在 Windows 和 Linux 上直接启动、控制并分析 AMD/Xilinx Vivado。
让 AI 处理 Vivado 的重复操作、报告读取和 Tcl 调用,你可以把精力放在 FPGA 架构、约束和问题判断上。
Vivado MCP Native 是一个面向 AMD/Xilinx Vivado 的本地 Model Context Protocol(MCP)服务器。它通过持久化 Vivado Tcl 会话,让 AI 客户端能够打开工程、运行综合与实现、生成比特流、读取时序和资源报告、控制仿真,并执行高级 Tcl 命令。
项目使用 Python subprocess 原生管理 Vivado 进程,可直接运行于 Windows 和 Linux,不依赖仅适用于类 Unix 环境的 pexpect。MCP 与 Vivado 都运行在用户本机,工程文件不会因为使用本项目而自动上传到云端。
[!IMPORTANT]
本项目不包含 Vivado。可用器件、IP、综合/实现功能和许可证能力,取决于本机安装的 AMD/Xilinx Vivado。
[!WARNING]
PyPI 上的
vivado-mcp属于另一个项目。本项目的安装包名称是 `vivado-mcp-native`。
它可以做什么
| 类别 | 主要能力 | 典型用途 |
|---|---|---|
| Vivado 会话 | 启动、停止、健康检查、状态统计、异常恢复 | 让 AI 复用同一个 Vivado Tcl 进程,避免每条命令都重新启动 Vivado |
| 工程管理 | 打开/关闭 .xpr 工程、读取工程信息 | 检查目标器件、顶层模块、工程目录和当前工程状态 |
| 设计流程 | 运行综合、实现、生成比特流 | 自动执行 synth_1、impl_1 和 bitstream 流程,并核对实际运行状态 |
| 时序分析 | 获取 WNS、TNS、WHS、THS 和关键路径 | 判断是否满足时序,定位 setup/hold 违例及跨时钟问题 |
| 资源分析 | 查询 LUT、FF、BRAM、DSP、IO 使用率 | 判断设计是否放得下,分析资源热点和层次化占用 |
| 消息诊断 | 获取 ERROR、CRITICAL WARNING、WARNING | 汇总综合和实现阶段的问题,辅助确定排查顺序 |
| 设计查询 | 查询层次结构、端口、网络和单元 | 核对综合后的连接关系、模块实例和信号名称 |
| Vivado 仿真 | 启动/重启/步进仿真、读取信号、设置断点 | 运行 xsim,查看 testbench、波形对象和指定信号值 |
| Tcl 扩展 | 执行任意 Vivado Tcl 命令 | 调用尚未封装为专用 MCP 工具的 Vivado 能力 |
| 大型报告 | 生成完整报告并按区段读取 | 避免超长报告一次性占满 AI 上下文窗口 |
可以直接对 AI 这样说
启动 Vivado,并检查当前会话是否健康。
打开 D:\FPGA\my_project\my_project.xpr,告诉我目标器件、顶层模块和当前运行状态。
运行综合,使用 8 个并行任务。完成后汇总 ERROR、CRITICAL WARNING 和资源利用率。
分析当前设计的时序,告诉我 WNS/TNS 是否满足,并列出最差的 10 条 setup 路径。
只分析 clk_250m 时钟域中经过 u_tdc 的失败路径,并给出可能的优化方向。
运行实现并生成 bitstream;每一步都确认 Vivado 的真实 STATUS 和 PROGRESS。
启动行为级仿真,运行 1 us,然后读取 /tb/dut/data_out 和 /tb/dut/valid。
执行 Tcl:report_drc -ruledecks default,并总结需要优先处理的问题。
为什么使用这个项目
| 常见问题 | Vivado MCP Native 的处理方式 |
|---|---|
Windows 下传统 pexpect 方案难以直接运行 | 使用原生 subprocess 启动 vivado.bat、vivado.cmd 或 Linux vivado |
| Vivado 启动慢 | 多次 MCP 调用复用同一个持久 Tcl 会话 |
| Tcl 中包含引号、花括号、反斜杠或中文路径 | 使用 UTF-8 十六进制传输和唯一命令标记进行可靠分帧 |
| 本地化 Vivado 提示符可能变化 | 不依赖 Vivado% 提示符解析命令边界 |
| 长命令超时后容易留下 Vivado 子进程 | 超时后清理完整进程树,避免残留失步会话 |
| 报告太长,AI 无法一次读完 | 支持完整报告落盘并按行或正则表达式分段读取 |
| 不确定 Vivado 路径和编码是否正确 | 提供 vivado-mcp-native-doctor 一键诊断 |
环境要求
| 组件 | 要求 |
|---|---|
| 操作系统 | Windows 10/11 或 Linux |
| Python | 3.10–3.12 |
| Vivado | 本机已经安装 AMD/Xilinx Vivado |
| 许可证 | 覆盖计划使用的器件、IP 和设计流程 |
| MCP 客户端 | 支持本地 stdio MCP Server |
安装
方式一:使用 pip 安装
Windows PowerShell:
py -m pip install --upgrade vivado-mcp-native
Linux:
python3 -m pip install --upgrade vivado-mcp-native
检查安装结果:
py -m pip show vivado-mcp-native
vivado-mcp-native-doctor --help
方式二:使用 pipx 安装(推荐)
pipx 会为 MCP Server 创建独立 Python 环境,减少与其他 Python 包的依赖冲突。
Windows:
py -m pip install --user --upgrade pipx
py -m pipx ensurepath py -m pipx install vivado-mcp-native
Linux:
python3 -m pip install --user --upgrade pipx
python3 -m pipx ensurepath python3 -m pipx install vivado-mcp-native
升级:
py -m pipx upgrade vivado-mcp-native
方式三:直接从 GitHub 安装
安装 master 分支最新源码:
py -m pip install --upgrade "git+https://github.com/Arthurzxy/vivado_mcp_native.git@master"
使用 pipx:
py -m pipx install --force "git+https://github.com/Arthurzxy/vivado_mcp_native.git@master"
不依赖本机 Git,也可以安装 GitHub ZIP:
py -m pip install --upgrade "https://github.com/Arthurzxy/vivado_mcp_native/archive/refs/heads/master.zip"
用于开发或修改源码:
git clone https://github.com/Arthurzxy/vivado_mcp_native.git
cd vivado_mcp_native py -m pip install -e .
安装后提供的命令
| 命令 | 作用 |
|---|---|
vivado-mcp-native | 启动 MCP stdio Server |
vivado-mcp-native-doctor | 检查 Python、Vivado、Tcl 和 Unicode 通信 |
vivado-mcp-win | 兼容旧配置的 Server 别名 |
vivado-mcp-win-doctor | 兼容旧配置的 Doctor 别名 |
快速开始
第一步:确认 Vivado 启动文件
VIVADO_PATH 可以指向:
- 完整启动文件:
vivado.bat、vivado.cmd、vivado.exe或 Linuxvivado; - Vivado 的
bin目录; - Vivado 版本目录。
Windows 示例:
$env:VIVADO_PATH = "D:\Software\Xilinx\2025.2.1\Vivado\bin\vivado.bat"
Linux 示例:
export VIVADO_PATH="/tools/Xilinx/Vivado/2025.2/bin/vivado"
未显式配置时,Server 会检查系统 PATH 和常见安装目录。
第二步:运行 Doctor
vivado-mcp-native-doctor --vivado-path "D:\Software\Xilinx\2025.2.1\Vivado\bin\vivado.bat"
机器可读 JSON 输出:
vivado-mcp-native-doctor --vivado-path "D:\Software\Xilinx\2025.2.1" --json
Doctor 会依次检查:
- Vivado 启动文件解析;
- 持久 Tcl 会话启动;
- Vivado 和 Tcl 版本查询;
- Tcl 表达式执行;
- 中文 Unicode 往返;
- 会话健康状态;
- Vivado 正常关闭。
Doctor 不会打开或修改用户工程。
第三步:配置 MCP 客户端
先查找安装后的命令路径:
(Get-Command vivado-mcp-native).Source
使用已安装的命令
把下面的 command 和 VIVADO_PATH 替换为你的实际路径:
{
"mcpServers": { "vivado": { "command": "C:\\Users\\you\\.local\\bin\\vivado-mcp-native.exe", "env": { "VIVADO_PATH": "D:\\Software\\Xilinx\\2025.2.1\\Vivado\\bin\\vivado.bat" } } } }
使用 Python 模块启动
适用于虚拟环境或 pip install 后不方便定位命令的情况:
{
"mcpServers": { "vivado": { "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python311\\python.exe", "args": ["-m", "vivado_mcp"], "env": { "VIVADO_PATH": "D:\\Software\\Xilinx\\2025.2.1\\Vivado\\bin\\vivado.bat" } } } }
建议使用可执行文件的绝对路径,避免 MCP 客户端与终端使用不同 PATH。
配置保存后,完全退出并重新启动 MCP 客户端,然后让 AI 执行:
检查 Vivado MCP 的主机状态,启动会话并返回 Vivado 版本。
推荐使用流程
1. vivado-mcp-native-doctor 检查本机环境
- start_session 启动持久 Vivado Tcl 会话
- open_project 打开 .xpr 工程
- get_project_info 确认器件、工程和顶层信息
- run_synthesis 运行综合
- get_messages 查看错误和警告
- get_timing_summary 检查 WNS/TNS/WHS/THS
- get_utilization 检查 LUT/FF/BRAM/DSP/IO
- run_implementation 运行布局布线
- get_timing_paths 分析最差路径
- generate_bitstream 生成比特流
- stop_session 关闭 Vivado 并释放资源
综合和实现可能耗时较长。大型工程应在调用时增加 timeout,并根据 CPU 和内存情况设置合适的 jobs。
MCP 工具说明
会话管理
start_session:启动持久 Vivado Tcl 会话;stop_session:正常关闭 Vivado;session_status:查看命令数、错误数和会话统计;check_session_health:检查会话响应并按需恢复;get_host_status:查看主机名、可用内存和会话状态。
工程与设计流程
open_project/close_project:打开或关闭.xpr工程;get_project_info:获取当前工程信息;run_synthesis:运行综合并验证 Vivado 的实际状态;run_implementation:运行 place and route;generate_bitstream:为已实现设计生成 bitstream。
报告与设计查询
get_timing_summary:返回 WNS、TNS、WHS、THS 等结构化指标;get_timing_paths:按时钟、起点、终点或 through 对象过滤关键路径;get_utilization:返回 LUT、FF、BRAM、DSP 和 IO 使用率;get_clocks:获取时钟与约束信息;get_messages:分类读取 ERROR、CRITICAL WARNING 和 WARNING;get_design_hierarchy:读取综合后设计层次;get_ports/get_nets/get_cells:查询端口、网络和单元。
仿真
set_simulation_top:设置 testbench 顶层;launch_simulation:启动行为级或综合/实现后仿真;run_simulation/step_simulation/restart_simulation:运行、步进或重启;get_signal_value/get_signal_values:读取一个或一组信号;get_scopes/get_simulation_objects:浏览仿真层次和对象;add_signals_to_wave:添加波形信号;add_breakpoint/remove_breakpoints:管理仿真断点;get_simulation_messages:读取仿真日志;close_simulation:关闭仿真。
高级能力
run_tcl:执行任意 Vivado Tcl;generate_full_report:生成 timing、utilization、power、DRC 等完整报告;read_report_section:按行范围或正则表达式读取大型报告;request_feature/list_feature_requests:记录当前未覆盖的功能需求。
工作原理
Claude / Cursor / Cline / Cherry Studio / 其他 MCP 客户端
│ │ MCP stdio / JSON-RPC ▼ Vivado MCP Native │ │ 持久 subprocess Tcl 会话 ▼ AMD/Xilinx Vivado -mode tcl │ ▼ 本机 FPGA 工程与报告
每条 Tcl 命令会使用 UTF-8 十六进制编码并附加唯一标记。Server 分别提取标准输出、Tcl 返回值、返回码和错误栈,不依赖可能随语言环境变化的 Vivado% 提示符。
常见问题
找不到 vivado-mcp-native 命令
py -m pipx ensurepath
(Get-Command vivado-mcp-native).Source
重启终端或把返回的绝对路径直接写入 MCP 客户端配置。
找不到 Vivado
先验证启动文件:
& "D:\Software\Xilinx\2025.2.1\Vivado\bin\vivado.bat" -mode tcl
随后运行:
vivado-mcp-native-doctor --vivado-path "D:\Software\Xilinx\2025.2.1\Vivado\bin\vivado.bat"
中文输出乱码
$env:VIVADO_MCP_OUTPUT_ENCODING = "gbk"
可设置为 utf-8、gbk,或与本机 Vivado Tcl 控制台一致的编码。
综合或实现超时
超时后 Server 会终止完整 Vivado 进程树,防止继续使用已经失步的会话。重新启动会话,并为大型工程设置更长的 timeout。
vivado-mcp 和 vivado-mcp-native 是同一个包吗
不是。安装本项目请始终使用:
py -m pip install vivado-mcp-native
更多 Windows 配置说明参见 WINDOWS_INSTALL.md。
安全说明
run_tcl 可以按当前用户权限执行任意 Tcl,包括读写文件和启动外部程序。请注意:
- 只连接可信的 MCP 客户端和模型;
- 执行删除文件、重置工程或覆盖输出前检查目标路径;
- 对重要工程使用版本控制并保留备份;
- 不要把没有鉴权和隔离的 Vivado MCP 直接暴露到公网。
官方 MCP Registry
官方 Registry 标识:
io.github.Arthurzxy/vivado-mcp-native
注册元数据位于 server.json,当前发布版本为 0.2.1,传输方式为本地 stdio。
贡献
欢迎通过 Issue 或 Pull Request:
- 补充新的 Vivado 工具;
- 改进不同 Vivado 版本的兼容性;
- 增强报告解析;
- 补充 MCP 客户端配置示例;
- 修正文档或翻译。
许可证与致谢
本项目使用 MIT License。
- 原始项目由 Corey Hahn 创建;
- 基于 Model Context Protocol;
- 集成 AMD/Xilinx Vivado。