Skip to content

v0.1.1 - CLI

Choose a tag to compare

View all tags
@xxin0816 xxin0816 released this 26 Aug 09:31
· 77 commits to main since this release
v0.1.1
ef0221d

v0.1.1 — 命令行接口

0.1.0 的所有能力保持不变，新增 wave-mcp query 命令行接口：
27 个 MCP 工具全部可以在终端直接调用，不挂 Code Agent 也能用。

新增：wave-mcp query

pip install wave-mcp

wave-mcp query --list          # 列出全部 27 个工具
wave-mcp query signal_values --session sessions/my_module \
    --full_path top.u_tx.tx_serial
wave-mcp query signal_drivers --session sessions/my_module \
    --json-args '{"full_path": "top.u_tx.tx_serial"}'
  • 参数按工具签名自动生成，wave-mcp query <工具名> --help 查看参数
  • 默认输出人读文本，加 --json 输出完整结构化结果
  • --session 一键打开 session，--json-args 支持 JSON 传参
  • 适合 CI 脚本、开发调试、快速验证
  • 以后每新增一个工具，自动获得 CLI 接口，零维护成本

兼容性

不带 query 子命令时，wave-mcp 的 MCP server 行为与 0.1.0 完全一致。

完整能力（继承自 0.1.0）

  • 27 个 MCP 工具 / 8 大类：层次探索、信号查询、值查询、驱动分析、值/X 态追踪等
  • 无波形静态分析（open_static_session）：仿真前仅凭 RTL 源码分析设计
  • VCD→FST 转换（convert_vcd_to_fst / wave-vcd2fst）
  • 生产级验证：225 万信号值查询正确性 100%，一百多个测试 case、310 万多次工具调用全部通过

v0.1.1 — Command-line interface

Everything from 0.1.0 stays the same, plus a new wave-mcp query CLI:
all 27 MCP tools are now callable directly from the terminal, no agent needed.

New: wave-mcp query

pip install wave-mcp

wave-mcp query --list          # list all 27 tools
wave-mcp query signal_values --session sessions/my_module \
    --full_path top.u_tx.tx_serial
wave-mcp query signal_drivers --session sessions/my_module \
    --json-args '{"full_path": "top.u_tx.tx_serial"}'
  • Flags are generated from each tool's signature; wave-mcp query <tool> --help
  • Human-readable output by default; --json for the full structured result
  • --session opens a session in one shot; --json-args accepts JSON arguments
  • Built for CI scripts, development debugging and quick checks
  • Every future tool gets a CLI surface automatically, zero maintenance

Compatibility

Running wave-mcp without the query subcommand behaves exactly like 0.1.0.

Everything from 0.1.0

  • 27 MCP tools across 8 categories: hierarchy, signals, values, drivers, value/X tracing, and more
  • Waveform-free static analysis (open_static_session) straight from RTL sources
  • VCD→FST conversion (convert_vcd_to_fst / wave-vcd2fst)
  • Production-grade validation: 2.25M signals at 100% value correctness, 100+ test cases, 3.1M+ tool calls all passed
Assets 2
Loading