Vcd

A Model Context Protocol (MCP) server for analyzing VCD waveforms and GTKWave save files (.gtkw).

Give your AI assistant direct access to hardware simulation results — signal values, bus definitions, display formats, and signal groupings — without dumping entire files into the context window.

Tools

Tool	Description
get-signal	Get all value changes of a signal from a VCD file. Supports optional start_time / end_time range filtering.
load-gtkw	Parse a .gtkw save file and return its full structure: metadata, signals, buses, and groups.
get-signal-groups	Return the group hierarchy defined in a .gtkw file.
get-bus-signals	Return the component signals of a named bus from a .gtkw file.
get-signal-with-format	Get signal values from a VCD, formatted according to .gtkw display hints (hex, decimal, binary, etc.).

Installation

uv pip install mcp-vcd

Claude Desktop

Add to your claude_desktop_config.json:

"mcpServers": {
  "mcp-vcd": {
    "command": "uv",
    "args": [
      "run",
      "mcp-vcd"
    ]
  }
}

See Anthropic's MCP documentation for more info.

License

MIT