集成
OpenBaud 串口设备 MCP 服务器
以 Rust 编写的 MCP 服务器兼 Codex 插件,为编程智能体提供可审计的本地串口设备访问:按 USB 元数据识别端口、发送分帧请求,并把收发的每个字节记录到无损的 .obcap 捕获文件中。探索中确认的设备行为保存为 YAML 设备配置、类型化命令和工作流,可校验校验和并解码标量、位字段和记录数组;同样的命令还能在没有硬件时对捕获文件重放。其完整演示解码的是作者为 ESP32-S3 测试板编写的小型二进制协议 OBP/1,而非现有的厂商协议。
- 目标
- 协议
- 类别
- 独立 MCP 集成
- 关联
- 独立智能体集成
- 来源复核于
使用条件与局限
- 这是一个很新的项目:仓库创建于 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 串口访问,并把验证过的行为记录为可复用命令;这些是项目自身的工作流规则。所审来源未确立与 REA 的关联。
关于此条目
说明已依据一手来源复核;这不代表已运行验证、经过安全审计或确认兼容。
一手来源
- README.md GitHub · Leonezz/openbaud · 修订 f3ebd89
- plugins/openbaud/README.md GitHub · Leonezz/openbaud · 修订 f3ebd89
- plugins/openbaud/skills/openbaud/SKILL.md GitHub · Leonezz/openbaud · 修订 f3ebd89
- crates/openbaud/src/mcp/tools.rs GitHub · Leonezz/openbaud · 修订 f3ebd89
- examples/pv-demo/README.md GitHub · Leonezz/openbaud · 修订 f3ebd89
- examples/pv-demo/protocol.md GitHub · Leonezz/openbaud · 修订 f3ebd89
- examples/pv-demo/captures GitHub · Leonezz/openbaud · 修订 f3ebd89
- plugins/openbaud/bin/darwin-arm64 GitHub · Leonezz/openbaud · 修订 f3ebd89
- Cargo.toml GitHub · Leonezz/openbaud · 修订 f3ebd89
- rust-toolchain.toml GitHub · Leonezz/openbaud · 修订 f3ebd89
- .github/workflows/ci.yml GitHub · Leonezz/openbaud · 修订 f3ebd89
- .github/workflows/release.yml GitHub · Leonezz/openbaud · 修订 f3ebd89
- LICENSE GitHub · Leonezz/openbaud · 修订 f3ebd89
- https://github.com/Leonezz/openbaud/releases/tag/v0.3.0