{ "added_at": "2026-11-03", "additional_evidence_urls": [ "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/README.md", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/skills/openbaud/SKILL.md", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/crates/openbaud/src/mcp/tools.rs", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/README.md", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/protocol.md", "https://github.com/Leonezz/openbaud/tree/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/examples/pv-demo/captures", "https://github.com/Leonezz/openbaud/tree/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/plugins/openbaud/bin/darwin-arm64", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/Cargo.toml", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/rust-toolchain.toml", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/.github/workflows/ci.yml", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/.github/workflows/release.yml", "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/LICENSE", "https://github.com/Leonezz/openbaud/releases/tag/v0.3.0" ], "category": "agent-mcp", "description_en": "Rust MCP server and Codex plugin that gives coding agents audited access to local serial devices, from identifying ports by USB metadata and sending framed requests to recording every received and transmitted byte in lossless .obcap captures. Device behaviour confirmed during exploration is kept as YAML device profiles, typed commands and workflows that validate checksums and decode scalars, bit fields and record arrays, and the same commands can be replayed against a capture without hardware. Its worked demo decodes OBP/1, a small binary protocol the author wrote for an ESP32-S3 test board, not an existing vendor protocol.", "description_zh": "以 Rust 编写的 MCP 服务器兼 Codex 插件，为编程智能体提供可审计的本地串口设备访问：按 USB 元数据识别端口、发送分帧请求，并把收发的每个字节记录到无损的 .obcap 捕获文件中。探索中确认的设备行为保存为 YAML 设备配置、类型化命令和工作流，可校验校验和并解码标量、位字段和记录数组；同样的命令还能在没有硬件时对捕获文件重放。其完整演示解码的是作者为 ESP32-S3 测试板编写的小型二进制协议 OBP/1，而非现有的厂商协议。", "entry_url": "https://awesomerea.org/resources/openbaud-serial-device-mcp/", "entry_url_zh": "https://awesomerea.org/zh/resources/openbaud-serial-device-mcp/", "evidence_url": "https://github.com/Leonezz/openbaud/blob/f3ebd8976ebeae071dbfb95a1f09c58204bbd57f/README.md", "group": "agents", "id": "openbaud-serial-device-mcp", "json_url": "https://awesomerea.org/resources/openbaud-serial-device-mcp/record.json", "kind": "integration", "markdown_url": "https://awesomerea.org/resources/openbaud-serial-device-mcp/index.md", "markdown_url_zh": "https://awesomerea.org/zh/resources/openbaud-serial-device-mcp/index.md", "name": "OpenBaud", "name_zh": "OpenBaud 串口设备 MCP 服务器", "record_type": "resource", "relationship": "independent-agent-integration", "requirements": [ "A young project: the repository was created on 2026-08-23 and had 48 commits at the reviewed v0.3.0 release commit of 2026-10-09. Cargo.toml declares version 0.3.0 and rust-toolchain.toml pins Rust 1.96.0. The README and plugin guide document installation only for Codex, through codex plugin marketplace add with the stable branch or a release archive; the server itself runs as openbaud mcp over stdio, and no other MCP client is documented.", "The v0.3.0 release provides plugin archives for macOS ARM64 and Intel, Linux x64 and ARM64, Windows x64 and a universal bundle, each with a SHA-256 file. The Node launcher needs Node.js 18+, and macOS binaries are ad-hoc signed but not notarized. A source checkout commits only the project's own macOS ARM64 runtime build, plugins/openbaud/bin/darwin-arm64/openbaud with a SHA-256 sidecar; other hosts build their runtime with plugins/openbaud/scripts/build-runtime and a Rust toolchain.", "Requires the user's own serial or USB-serial hardware. MCP tools cover listing and opening ports, raw read, send and request, running stored commands and workflows, captures, frame diagnosis and session statistics. Raw writes and device commands are marked potentially destructive, writes go to an append-only audit log, commands declared risk: danger need explicit acknowledgement, and commands with requires preconditions are refused until the session has established that device state. The README warns that serial writes can reconfigure or actuate hardware and advises starting unknown devices read-only.", "The example workspace holds a real OBP/1 request/response capture recorded from the author's ESP32-S3 board on 2026-08-24, whose radar points are generated by test firmware and flagged simulated_scene on the wire, and further captures whose notes describe a serial protocol tester sweep of AT, ELM327 OBD-II, Marlin, GPS NMEA and particulate-sensor framings. The reviewed tree contains no firmware, including that test firmware, and the media/pv directory the README cites for the demo video source is absent at this commit. CI runs Clippy, package validation, tests, native builds and MCP smoke tests on the five supported hosts.", "MIT (LICENSE, Cargo.toml). The bundled skill tells agents to use OpenBaud's tools instead of ad-hoc shell serial access and to record verified behaviour as reusable commands; these are the project's own workflow rules." ], "requirements_zh": [ "这是一个很新的项目：仓库创建于 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 串口访问，并把验证过的行为记录为可复用命令；这些是项目自身的工作流规则。" ], "targets": [ "protocol" ], "url": "https://github.com/Leonezz/openbaud", "verification": "source-reviewed", "verified_at": "2026-10-27" }