MCP (Model Context Protocol) は、ウェルンライブラリを使用して、波形ファイル(VCD/FST 形式)を読み込み、解析するためのサーバーです。

使用法

インストール

貨物によって取付けて下さい:

ビルドされたバイナリは [~/.cargo/bin/waveform-mcp] になります。

手動で取付けて下さい:

ビルドされたバイナリは [target/release/waveform-mcp] になります。

ランニング

サーバは2つのトランスポートモードをサポートしています。

• Stdio モード (デフォルト): MCP コミュニケーションのための標準的な入出力を使用して下さい
• ** HTTP モード**: [[[T2] エンドポイントでリモートアクセスが可能な HTTP サーバを使用する

HTTP モードで実行すると、指定したバインドアドレス (デフォルト: [127.0.0.1:8000]) でサーバが listen されます。 HTTP モードにより、波形ストアは複数の HTTP セッション間で共有され、波形ファイルのリモート解析が可能になります。

##特徴

• VCD(Value Change Dump)とFST(Fast Signal Trace)の波形ファイルを開きます
• 階層パスで波形のすべての信号をリスト
• 波形モジュール階層をインデントツリーとして読み込む
• 特定の時間指数(単一か複数の)の信号の価値を読みます
• 信号メタデータの取得(タイプ、幅、インデックス範囲)
• 時間範囲内の信号でき事(変更)を見つけて下さい
• タイムスケール情報(例「10ns」「5000ps」)で時間値を書式

Waveform MCP Server

An MCP (Model Context Protocol) server for reading and analyzing waveform files (VCD/FST format) using the wellen library.

Usage

Installation

Install via cargo:

cargo install waveform-mcp

The built binary will be at ~/.cargo/bin/waveform-mcp.

Install manually:

# Clone the repository
git clone https://github.com/jiegec/waveform-mcp
cd waveform-mcp

# Build the server
cargo build --release

The built binary will be at target/release/waveform-mcp.

Running

# Run the server with stdio transport (default)
target/release/waveform-mcp

# Run the server in HTTP mode
target/release/waveform-mcp --http

# Run the server in HTTP mode with custom bind address
target/release/waveform-mcp --http --bind-address 0.0.0.0:8000

The server supports two transport modes:

• Stdio mode (default): Uses standard input/output for MCP communication
• HTTP mode: Uses streamable HTTP server for remote access at /mcp endpoint

When running in HTTP mode, the server listens on the specified bind address (default: 127.0.0.1:8000). HTTP mode allows the waveform store to be shared across multiple HTTP sessions, enabling remote analysis of waveform files.

Features

• Open VCD (Value Change Dump) and FST (Fast Signal Trace) waveform files
• List all signals in a waveform with hierarchical paths
• Read the waveform module hierarchy as an indented tree
• Read signal values at specific time indices (single or multiple)
• Get signal metadata (type, width, index range)
• Find signal events (changes) within a time range
• Format time values with timescale information (e.g., “10ns”, “5000ps”)
• Streamable HTTP server support for remote access

Tools

The server provides 8 MCP tools:

1. open_waveform - Open a waveform file

   • file_path: Path to .vcd or .fst file
   • alias: Optional alias for the waveform (defaults to filename)
   • overwrite: Optional flag to reopen a waveform whose id is already open (default: false); otherwise opening an id twice is an error

   When the file does not exist, files with a similar name in the same directory are suggested. Failures are reported as tool errors, like every other tool.

   Example response:

   Waveform opened successfully with alias: waveform.vcd
   

2. close_waveform - Close a waveform and free its memory

   • waveform_id: ID or alias of the waveform to close

   Example response:

   Waveform 'waveform.vcd' closed successfully
   

3. list_signals - List all signals in an open waveform

   • waveform_id: ID or alias of the waveform
   • pattern: Optional pattern (a string or an array of strings) matched against the full signal path, e.g. tb.dut.abc_bank. Multiple patterns are OR-ed