English Français العربية

Verdi Bridge

السجل الرسمي أخرى

Inspect waveforms and navigate RTL in live Synopsys Verdi. Requires a licensed Verdi installation.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package verdi-bridge
Claude Code 
claude mcp add verdi-bridge -e 'VERDI_BRIDGE_DIR=<VERDI_BRIDGE_DIR>' -e 'VERDI_BRIDGE_HOST=<VERDI_BRIDGE_HOST>' -e 'VERDI_BRIDGE_CONTROL_PATH=<VERDI_BRIDGE_CONTROL_PATH>' -- uvx verdi-bridge==0.3.3 serve
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "verdi-bridge": {
            "command": "uvx",
            "args": [
                "verdi-bridge==0.3.3",
                "serve"
            ],
            "env": {
                "VERDI_BRIDGE_DIR": "<VERDI_BRIDGE_DIR>",
                "VERDI_BRIDGE_HOST": "<VERDI_BRIDGE_HOST>",
                "VERDI_BRIDGE_CONTROL_PATH": "<VERDI_BRIDGE_CONTROL_PATH>"
            }
        }
    }
}

متغيرات البيئة

  • VERDI_BRIDGE_DIR Private bridge directory on the Verdi host; omit to use the default ~/.verdi-bridge/session.
  • VERDI_BRIDGE_HOST SSH user@host; omit for a local Verdi GUI.
  • VERDI_BRIDGE_CONTROL_PATH Optional existing SSH ControlMaster socket path.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Give your RTL debugging agent eyes on the waveform
  2. Video walkthrough
  3. Quick start
  4. What you can do
  5. See it in a real debugging session
  6. Project status

Getting started · Tool reference · Architecture · 中文

Give your RTL debugging agent eyes on the waveform

Connect your AI agent to live Synopsys Verdi. Let it find signals, inspect transitions, move through simulation time, and open the driving RTL—all in the same GUI you use to debug.

“Add the FIFO read/write pointers, go 20 cycles before the error, and investigate why full stayed high.”

“When did BVALID drop? Show the handshake signals and the code that drives it.”

Verdi Bridge turns those requests into observations from your simulation and visible actions in nWave and nTrace. The agent reasons; the bridge observes. Eighteen typed MCP tools work locally or over SSH with your existing Verdi setup.

Video walkthrough

Ask an agent to investigate a bug, then watch it choose signals, inspect live waveforms and navigate RTL. A 1m38s silent demo: an English prompt and original English agent replies beside synchronized Verdi capture. This is a separate English-language run, not a translation. Tool calls are selected by the agent, not a replay script.

https://github.com/user-attachments/assets/b041c1bd-4be5-4040-b281-2f15001b1e35

English video · 中文视频

How this was recorded · Installation tutorial

Quick start

pip install verdi-bridge

Or run without a checkout using uv:

uvx verdi-bridge tcl-path

This prints the bundled Tcl adapter path. Load it in Verdi and connect your MCP client, then use uvx verdi-bridge serve as the stdio server. A licensed Verdi installation is required. Client: Python 3.11+; remote host: Python 3.6+ and Verdi's Tcl 8.6. No vendor software is bundled.

What you can do

WorkflowTools
Find and display signalsfind_signals, browse_scope, add_signals
Navigate an error windowset_cursor, set_time_window, jump_before_error
Inspect actual waveform valuesfind_transitions, get_value_changes, sample_signals
Summarize long windowscount_changes, sample_on_clock
Discover error times and clocksread_log, measure_clock
Follow drivers into RTLtrace_driver, read_source, read_source_file, goto_source

Waveform queries preserve X/Z values. Long windows on large FSDBs can run through Verdi's NPI reader outside the GUI, so the GUI stays responsive. Time arguments carry explicit units. The same interface works with different RTL designs; no FIFO-specific logic is built into the bridge. See the Python and CLI examples.

See it in a real debugging session

Tested with UART TX, AXI-Lite, FIFO and arbiter RTL in licensed VCS/Verdi sessions. The agent can put relevant signals on screen, inspect their changes, and navigate to source while you follow along.

Real RTL examples · Blind debugging trial · Validation results and limitations

Project status

Experimental v0.3.3. Live checks used Verdi T-2022.06-SP2-1 on Linux, including the SSH, session and large-FSDB changes of v0.3.2–v0.3.3 (up to a 2.7 GB FSDB). New-session startup is verified; attachment to an arbitrary existing GUI is not yet separately validated. The bridge does not automatically compile, edit or repair RTL.

Contributing · Trust boundary · Validation limits · Report an issue

Inspired by the agent-to-EDA-tool workflow of virtuoso-bridge-lite. This is an independent implementation. MIT licensed; see third-party notices. Not affiliated with Synopsys. Verdi is a Synopsys trademark.

الأسئلة الشائعة

ما هو Verdi Bridge؟

Inspect waveforms and navigate RTL in live Synopsys Verdi. Requires a licensed Verdi installation.

كيف أثبّت Verdi Bridge؟

يعمل على جهازك. في Claude Code: claude mcp add verdi-bridge -e 'VERDI_BRIDGE_DIR=<VERDI_BRIDGE_DIR>' -e 'VERDI_BRIDGE_HOST=<VERDI_BRIDGE_HOST>' -e 'VERDI_BRIDGE_CONTROL_PATH=<VERDI_BRIDGE_CONTROL_PATH>' -- uvx verdi-bridge==0.3.3 serve. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Verdi Bridge إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Verdi Bridge مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Verdi Bridge؟

ينشره RuihongY. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.