开源波形调试 MCP 的生产级实践

信心faithx

学习如何获取并部署腾讯开源的 wave-mcp(GitHub / PyPI),用 FST/VCD 波形与 RTL 网表启动 MCP Server,使用其 27 个工具执行层次探索、信号/值查询和驱动分析,并了解与 Claude Code、Cursor、VS Code Copilot 的 mcpServers 集成要点。文中列出安装来源、运行前提和需在仓库中核验的测试与许可细节。

图片解读

第 1 张 — 事实(只记录可读文字与直接可见项)

- 可读文字(按画面从上到下、分行记录,保留原大小写与标点):

1. AI 读波形不用买

2. License: 腾讯

3. 开源 wave-mcp

4. 波形调试 MCP 的

5. 生产级实践

- 可见界面/版式要素(事实):

- 背景为浅粉色。

- 字体为深灰/褐色,标题行字体明显比其余行大。

- “License:” 为英文单词,后接中文“腾讯”。

- “wave-mcp” 为小写并带连字符;“MCP”为大写字母。

- “腾讯”和“波形调试”两处文字下方或后方有青色/浅蓝色的高亮标记(矩形底色或下划式高亮,视觉为青色块突出)。

- 左上角有一个较大的左引号样式装饰(浅粉色,比背景更深或不透明)。

- 右下角靠近边缘处有一个很小的粉色长方形或短划线状装饰(比文本淡)。

- 文本整体左对齐,距左侧有统一边距。

- 无表格、无图表、无按钮或界面步骤指示元素可辨认。

第 1 张 — 无法辨认或不确定的内容

- 右下角的小粉色标记上方是否有极小文字或图标,无法辨认(太小且与背景颜色接近)。

- 图片最上方左引号装饰内部是否含有细微文字/图形(看起来为空装饰),无法确认有无额外信息。

第 1 张 — 推测(明确标注为推测,不视为事实)

- 该画面可能为幻灯片封面或宣传页(基于大标题、子标题与装饰元素的常见排版),但这只是推测。

- 文本意图可能是介绍“开源 wave-mcp”项目及其在“MCP 波形调试/生产级实践”方面的应用,且该项目许可为“腾讯”,但内容含义为推测。

- 青色高亮可能用于强调“腾讯”和“波形调试”两处要点(基于常见设计习惯),为推测。

补充说明

- 图中没有可识别的交互界面步骤、操作按钮或图表数据;未发现时间戳、版本号或作者署名(若有小字或标识,已在“无法辨认”中标注)。

SkillPI 作品解读

作品用途:

- 该条目介绍并宣告了由腾讯蓬莱实验室验证团队开源的 wave-mcp 项目,定位为一个开源的“波形调试 MCP Server”,用于读取仿真生成的 FST/VCD 波形与 RTL 网表,并对波形提供一组 MCP 工具集合,帮助芯片验证工程师进行层次探索、信号/值查询、驱动分析和值/X 态追踪等分析工作。

图片证据要点:

- 封面图文字明确写出“AI 读波形不用买”、“License: 腾讯”、“开源 wave-mcp”等,可视化元素支持这是一个面向宣传/介绍的幻灯片或海报样式页面;未发现操作界面、版本号或使用示例的截图。

关联 Skill 与典型使用步骤(依据来源中可核验的信息):

1) 产物准备:你需要已由仿真器导出的 FST 或 VCD 文件,以及对应的 RTL 网表(netlist/源文件),因为 wave-mcp 只消费这些波形文件而不跑仿真器本身。

2) 安装与获取:代码托管在 GitHub,且在 PyPI 上提供包(来源给出:GitHub:https://github.com/Tencent/wave-mcp,PyPI:https://pypi.org/project/wave-mcp),可通过 pip install 或从仓库克隆来获取。

3) 启动 MCP Server:根据项目定位,部署一个 wave-mcp 服务进程来加载 FST/VCD 与网表(具体命令、配置项与运行参数需参考仓库 README 与文档;来源摘要未给出具体命令示例)。

4) 使用 MCP 工具:项目宣称提供“27 个 MCP 工具、覆盖 8 个类别”,在服务启动并加载数据后,可通过这些工具进行层次探索、信号查询、值/驱动分析等操作(工具调用接口与参数需参考项目文档)。

5) 与 Code Agent 集成:可在 Claude Code、Cursor、VS Code Copilot 等 Code Agent 中配置 mcpServers,以便在这些开发环境中调用 wave-mcp(来源提到需“加一段 mcpServers 配置”,但未给出配置样例)。

复现前提(必备项):

- 可用的 FST 或 VCD 波形文件以及对应 RTL 网表;

- Python 运行环境与网络/权限以运行或部署 wave-mcp;

- 仓库 README、文档与示例配置(来源中指出代码在 GitHub 并有 PyPI 包,实际使用需参考仓库内文档)。

待核实项(来源中有声明但需在使用前核验):

- 并发与许可:来源称“MIT 协议,免费,不限机器数,不限并发”,需要在 GitHub 仓库 LICENSE 文件与项目文档中核验具体许可条款与任何商业/组织使用限制;

- 准确性与规模验证细节:来源提到在真实生产级项目上完成了“几十个模块,225 万信号级验证,值查询正确性 100%”等测试数据,这些具体测试用例、测试脚本和测试结果细节需在仓库或项目的测试报告里核验;

- 集成示例与配置:关于在 Claude Code、Cursor、VS Code Copilot 中的 mcpServers 配置,来源仅作说明,具体的配置格式与示例需在项目文档或 Issue 中查找。

可交付成果(基于来源可兑现的内容):

- 一个可部署的 open-source wave-mcp Server(二进制或 Python 包)用于读取 FST/VCD 与 RTL 网表;

- 一套 MCP 工具接口,用于层次/信号/值/驱动等波形分析;

- 与 Code Agent 的配置入口(需要用户按项目文档提供的配置完成集成)。

结论性说明(以事实或需核验项结束):

- 输入资料为来源摘要,完整操作命令、示例与配置未包含于该摘要,使用者需前往项目仓库(https://github.com/Tencent/wave-mcp)和 PyPI 页面(https://pypi.org/project/wave-mcp)查阅 README、使用示例与测试基线以完成部署与验证。未核实的声明(例如并发无限制、100% 值查询正确性等)应在项目文档或测试报告中进一步确认。

作品来源 ↗