# OpenBaud 串口设备 MCP 服务器

> 以 Rust 编写的 MCP 服务器兼 Codex 插件，为编程智能体提供可审计的本地串口设备访问：按 USB 元数据识别端口、发送分帧请求，并把收发的每个字节记录到无损的 .obcap 捕获文件中。探索中确认的设备行为保存为 YAML 设备配置、类型化命令和工作流，可校验校验和并解码标量、位字段和记录数组；同样的命令还能在没有硬件时对捕获文件重放。其完整演示解码的是作者为 ESP32-S3 测试板编写的小型二进制协议 OBP/1，而非现有的厂商协议。

- 类型：集成
- 目标：协议
- 类别：独立 MCP 集成
- 关联：独立智能体集成
- 来源复核于：2026-10-27
- 收录于：2026-11-03
- 原始资源：<https://github.com/Leonezz/openbaud>
- 一手来源：<https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/openbaud-serial-device-mcp/>
- 记录 JSON：<https://awesomerea.org/resources/openbaud-serial-device-mcp/record.json>
- 英文版：[English](https://awesomerea.org/resources/openbaud-serial-device-mcp/index.md)

## 使用条件与局限

- 这是一个很新的项目：仓库创建于 2026-08-23，截至 2026-10-09 的所审 v0.3.0 发布提交共有 48 次提交。Cargo.toml 声明版本为 0.3.0，rust-toolchain.toml 固定使用 Rust 1.96.0。README 和插件指南只记载了面向 Codex 的安装方式，即通过 codex plugin marketplace add 使用 stable 分支或发布归档；服务器本身以 openbaud mcp 经 stdio 运行，未说明其他 MCP 客户端的用法。
- v0.3.0 发布版提供 macOS ARM64 与 Intel、Linux x64 与 ARM64、Windows x64 的插件归档以及一个通用包，均附 SHA-256 文件。Node 启动器需要 Node.js 18+，macOS 二进制仅为临时签名，尚未公证。源码检出中只提交了项目自己构建的 macOS ARM64 运行时 plugins/openbaud/bin/darwin-arm64/openbaud 及其 SHA-256 附属文件；其他主机需用 plugins/openbaud/scripts/build-runtime 和 Rust 工具链自行构建。
- 需要用户自己的串口或 USB 串口硬件。MCP 工具涵盖列出和打开端口、原始读取、发送与请求、运行已保存的命令和工作流、捕获、帧诊断以及会话统计。原始写入和设备命令被标记为可能具有破坏性，写入会记入只追加的审计日志；声明为 risk: danger 的命令需要明确确认，带 requires 前提条件的命令在会话确立相应设备状态之前会被拒绝。README 提醒串口写入可能重新配置或驱动硬件，建议对未知设备先从只读操作开始。
- 示例工作区收录 2026-08-24 从作者的 ESP32-S3 开发板录得的一次真实 OBP/1 请求与响应，其中雷达点由测试固件生成，并在报文中以 simulated_scene 标明；另有若干捕获文件，其说明记载了用串口协议测试器扫描 AT、ELM327 OBD-II、Marlin、GPS NMEA 和颗粒物传感器等帧格式的过程。所审代码树不含任何固件（包括该测试固件），README 引用的演示视频源码目录 media/pv 在此提交中也不存在。CI 在五种支持的主机上运行 Clippy、打包校验、测试、原生构建和 MCP 冒烟测试。
- 采用 MIT 许可（LICENSE、Cargo.toml）。随附技能要求智能体使用 OpenBaud 的工具而不是临时的 shell 串口访问，并把验证过的行为记录为可复用命令；这些是项目自身的工作流规则。

## 一手来源

1. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/README.md>
2. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/README.md>
3. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/skills/openbaud/SKILL.md>
4. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/crates/openbaud/src/mcp/tools.rs>
5. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/README.md>
6. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/protocol.md>
7. <https://github.com/Leonezz/openbaud/tree/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/captures>
8. <https://github.com/Leonezz/openbaud/tree/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/bin/darwin-arm64>
9. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/Cargo.toml>
10. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/rust-toolchain.toml>
11. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/.github/workflows/ci.yml>
12. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/.github/workflows/release.yml>
13. <https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/LICENSE>
14. <https://github.com/Leonezz/openbaud/releases/tag/v0.3.0>

## 同分区更多条目：智能体与 MCP

- [JADX MCP Server（Qtty）](https://awesomerea.org/zh/resources/qtty-jadx-mcp-server/index.md) · 集成
- [usb-rea：USB 设备协议推断命令行工具与 MCP 服务器](https://awesomerea.org/zh/resources/usb-rea/index.md) · 集成
- [IDA NO MCP：面向 AI 编程工具的 IDA 反编译导出工具](https://awesomerea.org/zh/resources/ida-no-mcp/index.md) · 集成
- [ida-mcp-rs 无界面 IDA Pro MCP 服务器](https://awesomerea.org/zh/resources/ida-mcp-rs/index.md) · 集成
- [ida-multi-mcp 多实例 IDA Pro MCP 服务器](https://awesomerea.org/zh/resources/ida-multi-mcp/index.md) · 集成
- [x64dbg MCP（x64dbgMCP）调试器 MCP 服务器](https://awesomerea.org/zh/resources/x64dbgmcp/index.md) · 集成

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。