wave-mcp
by dv365lab
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOVAS_HOME | No | Same as VERDI_HOME, kept for older Verdi versions; VERDI_HOME takes precedence when both are set. Default: empty. | |
| VERDI_HOME | No | Verdi installation root directory (not the bin/ directory). Required to read .fsdb waveforms; wave-mcp looks for share/FsdbReader/linux64 under it. Default: empty (FSDB input unavailable, all other features work). | |
| VCD2FST_BIN | No | Path to the GTKWave vcd2fst executable. Default: 'vcd2fst' (looked up in PATH). | |
| FSDB2FST_BIN | No | Path to a prebuilt fsdb2fst binary. Default: empty (auto-detected; compiled on demand at first conversion). | |
| VWDB2VCD_BIN | No | Direct path to vwdb2vcd (used for VWDB waveform conversion); alternatively configure XCELIUM_HOME. Default: empty (same lookup as simvisdbutil, plus $VERISIUM_DEBUG_HOME). | |
| XCELIUM_HOME | No | Xcelium installation root directory (simvisdbutil is searched under tools/bin). Configure when reading .shm/.vwdb and the Cadence tools are not on PATH. Default: empty (searched in PATH, $XLM_ROOT/$CDS_INST_DIR, and the xrun directory). | |
| WAVE_MCP_TOKEN | No | Shared secret for HTTP transport (at least 16 characters, e.g. generated with openssl rand -hex 32). Required when binding HTTP to a non-loopback address; every request must then send Authorization: Bearer <same value>, otherwise 401. Not used for stdio. Default: empty (only --host 127.0.0.1 allowed). | |
| FSDB2FST_FREADER | No | Directly points to a copied share/FsdbReader directory, for machines with only the runtime libraries and no full Verdi install. Default: empty (auto-read from VERDI_HOME / NOVAS_HOME). | |
| SIMVISDBUTIL_BIN | No | Direct path to simvisdbutil (used for SHM waveform conversion). Default: empty (auto-detected as described for XCELIUM_HOME). | |
| WAVE_MCP_WORKERS | No | Maximum number of tool calls executed concurrently; excess calls queue. Default: '4'. | |
| WAVE_MCP_AUDIT_LOG | No | Audit log: one JSON line per tool call (time, request id, tool, status, error type, duration, dataset identity/version; no arguments or paths). Value is a file path (appended with mode 0600) or 'stderr'. Default: empty (no logging). | |
| WAVE_MCP_MAX_VIEWS | No | Maximum concurrent views; oldest is closed when exceeded; '0' means no limit. Default: '8'. | |
| WAVE_MCP_CACHE_ROOT | No | Root directory for derived caches (.fst that cannot be placed next to the original waveform, per-module netlist index, fsdb2fst build artifacts, viewer assets). Recommended when HOME has a quota. Default: ~/.wave-mcp/cache. | |
| WAVE_MCP_LINT_CODES | No | Comma-separated slang diagnostic codes appended to the built-in list treated as lint (not lowering trust). Only applies to codes slang reports as errors. Default: empty. | |
| WAVE_MCP_SHM_TMPDIR | No | Directory for temporary VCD files during SHM/VWDB conversion (deleted after conversion). Default: empty (same directory as the output FST). | |
| WAVE_MCP_SESSION_TTL | No | Seconds of idleness after which a session with no in-flight requests is closed; '0' disables reclamation. Default: '1800'. | |
| WAVE_MCP_LAZY_NETLIST | No | Lazy per-module netlist loading: '1' forces on, '0' disables. Default: empty (auto-enabled when netlist is >= 8 MB). | |
| WAVE_MCP_SESSION_ROOT | No | Root directory where sessions are placed when out_dir is not given. Recommended when HOME has a quota. Default: ~/.wave-mcp/sessions. | |
| WAVE_MCP_QUEUE_TIMEOUT | No | Maximum seconds to wait in the queue before returning queue_timeout. Default: '30'. | |
| WAVE_MCP_VIEWER_ASSETS | No | Waveform viewer asset directory (must contain surver and wasm/index.html); set automatically by offline bundle installs. Default: empty (pip asset package, then ~/.wave-mcp/cache/viewer/). | |
| WAVE_MCP_QUEUE_CAPACITY | No | Queue capacity; when full, calls immediately return server_busy. Default: '32'. | |
| WAVE_MCP_SHUTDOWN_GRACE | No | Grace period in seconds for running calls after SIGTERM/SIGINT before forced exit. Default: '30'. | |
| WAVE_MCP_VIEWER_PORT_BASE | No | Restrict viewer ports to [base, base+64) for a fixed ssh -L forwarding rule; each user gets a non-overlapping range. Default: empty (random high ports). | |
| WAVE_MCP_PER_OWNER_RUNNING | No | Maximum concurrently running calls per user, preventing one client from occupying all slots. Default: '2'. | |
| WAVE_MCP_FSDB2FST_AUTOBUILD | No | Set to '0' to disable automatic first-time compilation of fsdb2fst. Default: '1' (enabled). | |
| WAVE_MCP_PER_OWNER_SESSIONS | No | Maximum simultaneously open sessions per user; excess returns resource_limit. Default: '16'. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues