Buspirate MCP

公共汽车海盗mcp

MCP服务器用于BusPirate 6硬件安全测试。显示UART、SPI、I2C、1-Wire、电源、GPIO和逻辑分析仪操作 模型上下文协议 工具通过stdio传输。跨4种总线协议的33个工具+逻辑分析仪。

专为与Claude Code一起使用而构建，但适用于任何MCP客户端。

它的作用

• UART探测： 检测波特率，捕获串行输出，与调试控制台交互
• SPI闪存： 探针JEDEC ID，读/转储/写SPI闪存芯片（W25Q系列，SOIC-8夹）
• I2C总线： 扫描设备、读/写寄存器、转储EEPROM内容
• 1-Wire： 枚举设备，读取ROM代码（DS18B20、iButton）
• 电源控制： 具有安全等级的电压/电流管理
• GPIO控制： 用于引导加载程序入口的拨动引脚（ESP32、ESP8266等）
• 闪光提取： 通过esptool通过UART桥转储固件
• 逻辑分析仪： 在所有8个IO引脚上以75 MHz的频率进行后续捕获，并带有协议标识
• 参与度记录： 每个协议日志（UART文本、SPI/I2C/1-Wire JSONL）、每个参与文件夹

需求

• Python 3.11+
• 启用BPIO2二进制模式的BusPirate 6
• 用户在 dialout 串行访问组(sudo usermod -aG dialout $USER)

安装

git clone --recurse-submodules https://github.com/mplogas/buspirate-mcp.git
cd buspirate-mcp
pip install -e ".[dev]"

MCP客户端配置

复制示例配置并调整计算机的路径：

cp .mcp.json.example .mcp.json
# Edit .mcp.json with the absolute path to your venv's python

这 .mcp.json 由于路径是特定于机器的，因此被忽略。配置示例：

{
  "mcpServers": {
    "buspirate": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "buspirate_mcp"]
    }
  }
}

集 PIDEV_ENGAGEMENTS_DIR 环境变量，用于控制参与日志的写入位置。默认为 ./engagements/ 相对于包根。

工具

安全模型

在MCP服务器边界强制执行三层：

• 只读： 完全自主，无副作用
• 允许写入： 自主执行，记录所有调用
• 批准书： 直到人类确认为止 _confirmed 参数。错误的电压会炸掉芯片。SPI闪存写入和I2C写入不可逆地覆盖数据。

BusPirate 6设置

启用BPIO2二进制模式

连接到BP6终端端口（ACM0）并运行：

binmode -> select 2 (BPIO2 flatbuffer interface) -> y to save

这种情况在重新启动后仍然存在。

引脚映射

UART模式使用IO4（TX->）和IO5（RX\ACM2）。服务器自动检测。

测试

pytest              # 203 tests, no hardware needed
pytest -m hardware  # integration tests, BP6 must be connected

许可证

麻省理工学院