BonengDriveMCP

面向 Boneng 驱动器的本地 MCP 服务，供 Codex 等 MCP 客户端调用。当前版本 0.11.1，提供 54 个工具。

通过已有 Drivesoft 通信组件连接真实驱动器，支持在线参数、运行控制、示波器及固件验证任务。固件代码修改由 Codex 的文件/终端工具完成，设备操作由本 MCP 执行。

当前支持的功能

完整工具名称见工具索引，运动细节见运动控制。

Related MCP server: opcua-twin-gateway

支持设备与实测范围

CM55本次在线调速后，稳定阶段采样反馈约为 1992～2008rpm；最终确认零速、停止状态及PC控制权释放。运行中仍有风扇相关警告50/1，故障码为0。该记录不代表警告原因已解决、额定3000rpm已验收或长期运行已验证。

位置控制仍待实机验收。 CM55实际参数写入、故障复位、示波器采集和烧录也需要分别验收。其他型号、固件构建和硬件配置需额外适配。

开发环境 161项单元/厂商组件回环测试通过，0跳过；干净环境STDIO检查确认54个工具。缺少厂商软件或未构建桥接器时，对应测试会明确跳过。详见验证范围。

环境要求

• Windows；实机通信依赖已检查的 Drivesoft V1.28测试版及依赖文件，需自行准备。

• Python 3.11+，安装示例使用Python 3.12；PowerShell 7；.NET Framework及其C#编译器。

• 使用DCP扫描时需要可用网卡和WinPcap/Npcap；仅串口操作不需要抓包驱动。

• 桥接构建脚本核对原厂EXE哈希；其他Drivesoft版本需核对后适配。

这是源码发布包，不含原厂EXE/DLL/许可证/数据库、驱动固件、固件源码、协议文档、设备绑定、现场波形和日志，也不是免安装的独立EXE。

安装：按顺序执行

以下在 PowerShell 7 中运行。目录可替换，中文和空格路径均可使用；先进入项目目录，再运行脚本。

# 1. 获取源码并进入目录；已有源码可跳过clone
git clone https://github.com/time32/BonengDriveMCP.git C:\Work\BonengDriveMCP
Set-Location 'C:\Work\BonengDriveMCP'

# 2. 明确使用Python 3.12创建虚拟环境
py -3.12 --version
py -3.12 -m venv .venv

# 3. 改成你自己的原厂软件目录
$env:BONENG_RELEASE_DIR = 'C:\Vendor\BonengDrivesoft 100(V1.28)_Test'
$env:BONENG_PWSH_PATH = (Get-Command pwsh -ErrorAction Stop).Source

# 4. 安装依赖、生成本机配置、构建通信桥
.\scripts\Setup.ps1
.\scripts\Build-ReuseBridge.ps1 -ReleaseDir $env:BONENG_RELEASE_DIR

没有py -3.12时，安装对应Python，或使用自己的Python 3.11+解释器绝对路径执行-m venv .venv。不要借用其他电脑的.venv，也不要在Python 3.9/3.10下创建环境。

构建成功后应有：

.venv/Scripts/python.exe
codex.config.toml
workspace/reuse_bridge/ReuseReadProbe.exe
workspace/reuse_bridge/ReuseDeviceBridge.exe
workspace/reuse_bridge/ReuseFirmwareUpgrade.exe

源目录和scripts/须保留；无需手动打开原上位机窗口，也不要让其他软件同时占用该串口。

接入 Codex

合并生成的配置

1. 打开项目根目录自动生成的codex.config.toml。

2. 将[mcp_servers.boneng_drivesoft]和对应.env表合并到Codex实际使用的配置文件。默认用户级路径为%USERPROFILE%\.codex\config.toml；也可使用受信任项目内的.codex/config.toml。保留已有其他配置，同名服务器应更新原表，避免重复定义。

3. 保存为UTF-8，在Codex的MCP服务器设置中重启该连接，再开始新聊天或刷新工具列表。

4. 如安装了Codex CLI，运行codex mcp list检查注册状态。

用户级配置适合在多个驱动固件源码项目中共用。连接参数依据OpenAI官方MCP文档。

下面说明配置结构，实际应使用安装脚本按本机位置生成的文件：

[mcp_servers.boneng_drivesoft]
command = "C:/Work/BonengDriveMCP/.venv/Scripts/python.exe"
args = ["-u", "C:/Work/BonengDriveMCP/run_server.py"]
cwd = "C:/Work/BonengDriveMCP"
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 180

[mcp_servers.boneng_drivesoft.env]
BONENG_RELEASE_DIR = "C:/Vendor/BonengDrivesoft 100(V1.28)_Test"
BONENG_WORKSPACE = "C:/Work/BonengDriveMCP/workspace"
BONENG_DATA_DIR = "C:/Work/BonengDriveMCP/data"
BONENG_PWSH_PATH = "C:/Program Files/PowerShell/7/pwsh.exe"

PowerShell安装在其他位置时，以Get-Command pwsh显示的路径为准。TOML路径可使用/；双引号内使用反斜杠时应写成\\。原AN串口还需要用户核对的BONENG_SERIAL_MAC，当前旧适配限COM7；CM55不需要AN的MAC。

验证连接

先向Codex发送：

调用 boneng_drivesoft 的 get_capabilities，确认版本0.11.1和已配置能力。本次只读，不启动电机、不写参、不烧录。

客户端应列出54个工具。仅看到服务器名称不代表设备已连接，get_capabilities不会主动连接驱动器。

CM55首次使用：

设备是COM7上的CM55。先只读识别型号和固件，确认后绑定该串口并读取状态。

AN网络设备：

列出网卡并扫描设备，将结果给我选择，选定后再建立连接。

实际端口和目标由使用者指定，发布包没有预选实机设备。

使用示例

持续运行由独立后台进程维持心跳，关闭聊天不会停止电机。未说明运行方式时会询问持续或限时。调速遵守会话上限和方向；若另设较低上限，或新速度超出会话固定编码范围，需要停机后重建会话。

大范围给定采用百分比编码，预览显示实际分辨率及量化值。例如基准3000rpm时，可能使用0.3rpm步长，不能将所有量程都视作0.01rpm精度。

绝对定位需要明确软件/设备零点；10000指令脉冲不代表一圈。MCP不自动执行回零或推断机械零点；断电、复位、重新回零或重启MCP后须重建参考。

当前限制

• 单实例仅一个后台运动任务，尚不能并行控制五台驱动器或实现多轴实时同步。

• 位置控制仍待实机验收；阈值触发、32位示波器、批量参数执行尚未接入。

• 示波器时间轴为名义采样周期，无设备时间戳及可靠丢点检测。

• 自动验证任务不替代人工重启；编译和代码修改由Codex协调，不会仅凭统计结果宣称已定位根因。

• 单台设备上的短时结果不能推广为其他配置或长期运行验收。

测试与源码包

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe scripts\smoke_test_clean.py
.\.venv\Scripts\python.exe scripts\package_github.py

smoke_test_clean.py使用空数据和隔离目录，不连接真实设备。厂商组件回环使用本机模拟端点，缺少厂商软件时会跳过对应测试。

仓库的release-assets目录提供当前源码ZIP及SHA-256校验文件；修改后，打包脚本在本机dist/生成新包。ZIP只包含发布源码、脚本、测试、文档和文件哈希清单。

更多文档：部署细节 · 运动控制 · 工具索引 · 验证范围 · 发布边界。

许可与需要补充的信息

本项目采用MIT许可证，版权署名为Copyright (c) 2026 time32。厂商软件和第三方依赖分别遵循自身许可，见许可与第三方声明。

后续完善发布还可补充：原厂依赖的获取说明，以及优先补齐的型号/固件和位置控制实机验收范围。这些不影响按本文部署当前功能。