Wisent Wire MCP（硬件测试 AI 助手） Skill 技能

技能简介

Wisent Wire MCP 是 Wisent Wire 硬件测试平台官方推出的 Model Context Protocol 服务器，让 AI 编程助手（Claude Code、Claude Desktop）能够直接控制电源、读写 UART/RS485/CAN 总线、烧录固件、跟踪 GDB 调试会话、维护设备注册表并预约实验室工位。它面向嵌入式工程师、硬件 QA 团队与 IoT 设备开发者，将"自然语言驱动实验台"变成可能，跨 macOS / Linux / Windows（WSL），需 Python 3.10+。

核心能力

1. 电源控制与设备遥测：远程打开/关闭电源轨，实时读取电压、电流与温度等遥测数据。
2. GPIO 控制：配置 GPIO 方向、上下拉并批量读写电平状态，覆盖 DUT 引脚矩阵。
3. 总线协议调试：原生支持 UART、RS485、CAN 帧收发，可用于外设通信抓包与回环测试。
4. 固件烧录与 flasher 目录：维护 flasher catalog，按 MCU 型号选择烧录算法并执行 production-grade 烧写。
5. GDB 调试会话：在 AI 端发起 GDB remote 调试，下断点、读寄存器与堆栈、step/continue 全程交互。
6. 设备注册与实验室预约：登记 DUT 序列号、固件版本、测试历史，预约实验台时间段避免冲突。
7. 协议帧定义库：内置 CAN/UART 协议帧定义模板，便于测试用例自动生成与解析。

安装配置

1. 安装 pipx（一次性）：macOS 用户执行 brew install pipx && pipx ensurepath；Linux/WSL 用户执行 python3 -m pip install --user pipx && python3 -m pipx ensurepath，然后重启终端使 PATH 生效。
2. 安装 MCP 服务器：pipx install wisent-wire-mcp，完成后 which wisent-wire-mcp 应返回可执行文件路径。
3. 升级与回滚：pipx upgrade wisent-wire-mcp 升级，pipx uninstall wisent-wire-mcp 卸载。
4. 配置 .mcp.json：在项目根目录的 .mcp.json 或用户级 ~/.claude.json 中加入 { "mcpServers": { "wisent-wire": { "command": "wisent-wire-mcp", "env": { "WISENT_WIRE_API_KEY": "wwk_..." } } } }，重启 Claude Code 即生效。
5. 后端 URL 配置：默认连生产环境，需要自托管时设置 WISENT_WIRE_URL 环境变量指向内部 API。

使用步骤

1. 在 Settings → API keys 创建 wwk_ 开头的 API Key 并写入 .mcp.json 的环境变量。
2. 在 Claude Code 中输入"列出我名下的实验台设备"，自动调用设备注册表工具返回候选 DUT。
3. 选定 DUT 后输入"给 device-001 上电到 3.3V 并读电流"，依次触发电源控制与遥测读取。
4. 输入"通过 UART 向 115200 baud 发送 AT+RST 并读取回显"，发起 UART 收发调试。
5. 输入"使用 GDB 在 main.c:42 设置断点并 continue"，启动远程 GDB 会话并把寄存器/堆栈渲染到对话中。
6. 结束测试后输入"关闭电源并释放实验台预约"，服务器执行清理并撤销占用。

适用场景

• 嵌入式产品回归测试：CI 阶段调用 wisent-wire-mcp 自动跑通电源 → 固件 → 总线回环用例。
• 实验室工位冲突协调：硬件团队用 AI 助手查询空闲工位并预约时间段。
• 现场调试：远程工程师通过 Claude 让 AI 控制实验台执行电源循环、UART 抓包。
• 固件版本对比：在不同固件版本上重复同一组硬件测试，AI 收集结构化结果。
• 培训与知识传递：硬件新手用自然语言学习 GDB 调试与 CAN 帧解析流程。

适用人群

• 嵌入式软件工程师与硬件 QA 团队。
• 物联网/汽车电子厂商的量产测试工程师。
• 需要远程调试硬件的分布式研发团队。
• 用 AI 助手统一管理实验台资源的高校实验室负责人。

工作原理

服务器以 stdio 进程方式接入 MCP 客户端，每次 Tool 调用都经 wwisent Wire SDK 转发到 Wisent Wire 后端 API，平台层负责设备发现、权限校验与遥测采集；服务器本身只做协议转换，把 Claude 传入的参数映射成 Power、GPIO、UART、CAN、GDB 等底层动作，并把遥测数据/日志结构化回传给客户端，从而让 AI 在不感知固件、JTAG、CAN 协议栈细节的情况下完成硬件调试。

官方链接

• PyPI：https://pypi.org/project/wisent-wire-mcp/
• 官网：https://wisent-wire.com
• SDK：https://pypi.org/project/wisent-wire-sdk/