MCP (Model Context Protocol) 서버는 잘 라이브러리를 사용하여 파형 파일 (VCD/FST 형식)를 읽고 분석합니다.

사용법

설치

화물을 통해 설치:

내장 된 바이너리는 ~/.cargo/bin/waveform-mcp에있을 것입니다.

수동 설치:

내장 된 바이너리는 target/release/waveform-mcp에있을 것입니다.

실행

서버는 2개의 수송 형태를 지원합니다:

• Stdio 모드 (기본값): MCP 통신을 위한 표준 입력/출력을 사용하십시오
• HTTP 모드: 원격 액세스에 대한 스트림 가능한 HTTP 서버를 사용합니다 /mcp endpoint

HTTP 모드에서 실행할 때, 서버는 지정된 바인드 주소(기본값: 127.0.0.1:8000)를 듣습니다. HTTP 모드는 여러 HTTP 세션을 통해 파형 저장소를 공유할 수 있으며, 파형 파일의 원격 분석이 가능합니다.

특징

• VCD (Value Change Dump) 및 FST (Fast Signal Trace) 파형 파일 열기
• 파형의 모든 신호를 hierarchical 경로로 나열
• 파형 모듈 hierarchy를 indented 트리로 읽으십시오.
• 특정 시간 지수 (단일 또는 다중)에서 신호 값 읽기
• 신호 메타데이터(type, width, index range) 취득
• 시간 범위 내에서 신호 이벤트 (changes) 찾기
• timescale 정보 (예: “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