Skip to main content
Glama
mcp-vcd
by key2

mcp-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.).

Related MCP server: EDA Tools MCP Server

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

Available Tools

5 tools
get-bus-signalsA

Return the component signals of a bus defined in a .gtkw file

Inputs: bus_name (required), file_name (required).

get-signalB

Get all value changes of a signal in a VCD file

Inputs: file_name (required), signal_name (required), end_time, start_time.

get-signal-groupsB

Return the group hierarchy from a parsed .gtkw file

Inputs: file_name (required).

get-signal-with-formatC

Get signal values from a VCD file, formatted according to .gtkw display hints

Inputs: vcd_file (required), gtkw_file (required), signal_name (required), end_time, +1 more.

load-gtkwB

Parse a .gtkw file and return its full structure (metadata, signals, buses, groups)

Inputs: file_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation4/5

    Tools are generally distinct, but get-signal and get-signal-with-format overlap in purpose (both retrieve signal values from VCD), though the formatting difference is clearly described. Other tools target distinct aspects of GTKW structure.

    Naming Consistency5/5

    All tool names follow a consistent lowercase hyphenated verb_noun pattern (get-*, load-*), making the naming predictable and easy to understand. The use of 'load' for gtwk parsing and 'get' for data retrieval is a consistent semantic distinction.

    Tool Count5/5

    With 5 tools, the server is well-scoped for its purpose of reading and inspecting VCD/GTKW files. Each tool covers a necessary aspect without redundancy or bloat.

    Completeness4/5

    The toolset covers the core workflows: parsing GTKW structure, querying groups/buses, and retrieving signal values. A minor gap is the lack of a direct way to enumerate all signals from a VCD file without a GTKW file, but this matches the typical workflow where GTKW provides the signal hierarchy.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables analysis of RTL waveform files (VCD, FST) through WAL (Waveform Analysis Language). Supports signal inspection, transition extraction, and advanced waveform queries for hardware design verification.
      16
      BSD 3-Clause
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to perform Electronic Design Automation (EDA) tasks including Verilog synthesis, simulation, ASIC design flows, and waveform analysis through a unified interface.
      6
      ISC
    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that provides AI assistants with a persistent, sandboxed Python environment for waveform analysis, enabling loading and manipulation of VCD/FST/FSDB files and temporal pattern matching.
      9
      -
    • A
      license
      A
      quality
      B
      maintenance
      Local MCP server for querying VCD waveform files via SQLite; enables AI agents to ask precise questions about signal values, transitions, and clock cycles without dumping raw VCD text.
      18
      2
      MIT