Skip to main content
Glama

BonengDriveMCP

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

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

当前支持的功能

功能

已实现内容

主要边界

设备识别

串口只读握手、型号/固件识别、显式绑定设备

CM55没有已验证唯一UID,换机须重新选择

网络发现

选择网卡、PROFINET DCP扫描、用户选择后TCP连接

当前网络适配为AN,尚无永久IP配置工具

在线参数目录

从当前设备读取分组、功能码地址、名称、位宽、权限及属性

各型号含义以在线目录为准,不依赖旧工程文件

参数读写

16/32位读取;单参数预览、一次写入、回读校验

每次读取最多20项;通用写参要求停机,命令寄存器受限制

参数备份

按组/全机读取实际配置、保存JSON快照、比较差异

批量配置仅能预览,尚无整套参数恢复/回滚

速度运行

上限按当前电机在线额定转速及设备限制确定;正反向、持续或限时运行

需明确现场条件;CM55暂限rpm;使用驱动器内部斜坡

运行中调速

同一连接中预览并执行调速,保持独立后台心跳;可给定零速

遵守本次会话上限/方向,给定回读不等于实际达速

相对/绝对定位

软件零点、指令脉冲坐标、位置JOG、内部加减速、到位后停机及恢复临时设置

当前只完成模拟/回环验证;不执行回零,不保持使能/转矩

停机与复位

OFF1停机、核对运行位并释放PC控制;非运行状态下故障复位

软件停机接口,不能代替现场停机措施

示波器

从在线目录选择1~4个16位P通道,立即触发,导出原始/换算CSV

2~1000ms偶数周期,最多20000点且不超过40秒;无可靠丢点检测

固件升级

固件登记封存、SHA-256、型号/版本预检、单次烧录、Flash读回、重启后验证

AN串口/TCP,CM55串口;已适配的SPI格式,手动重启

验证任务

可选备份→烧录一次→等待手动重启→核对身份→采集→统计/对比

任务本身不启动电机,不自动重刷或判定根因

离线分析

CSV范围/均值/RMS/峰峰值、参数集比较、批量变更预览

离线枚举/程序集参考工具需要自行提取的可选参考数据库

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

Related MCP server: opcua-twin-gateway

支持设备与实测范围

产品

连接

当前适配与实测

AN PN

串口或TCP 1000

平台9、已核对的9.10构建(6908/6A22);已有部分读写、采集、300rpm控制及升级闭环记录

CM55 EC

Windows串口,460800/8N1

平台3、6.12/6629;在线目录/读参/备份、300rpm限时运行,以及500/1000/2000rpm运行、1000→2000rpm在线调速和停止有短时实机记录

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网络设备:

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

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

使用示例

需求

可以给Codex的指令

读参数

“读取当前设备的B05.01和D00.05,说明在线名称与单位。”

备份

“备份当前设备的B05组参数,并与上次备份比较。”

速度运行

“电机空载、现场可立即停机,正向500rpm持续运行,上限按在线额定转速;先核对设备状态。”

在线调速

“将当前目标改为1000rpm,保持同一心跳连接。”

停止

“停机,确认实际零速并释放PC控制。”

位置

“先询问是否将当前停止位置设为软件零点,单位用指令脉冲,再预览相对移动10000脉冲。”

波形

“列出当前可采通道,由我选择后以2ms、1000点采集。”

固件闭环

“登记我编译好的固件,按本次授权预检烧录;我重启后自动采集已选通道。”

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

大范围给定采用百分比编码,预览显示实际分辨率及量化值。例如基准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。厂商软件和第三方依赖分别遵循自身许可,见许可与第三方声明。

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

Available Tools

54 tools
apply_device_parameter_writeA
Destructive

用户明确指定本次参数和值后执行计划:重查设备/固件/旧值/属性,停机状态下写入单个参数并读回。可能保存 EEPROM;失败不自动重试。运行/重启命令使用专用流程。

Inputs: plan_id (required). Returns: object

apply_drive_speed_changeA
Destructive

执行用户要求的单次调速,复用运行连接及心跳,优先于长采集;再次核对版本和电机参数并回读给定。给定回读成功不代表实际达速,失败不自动重试。

Inputs: plan_id (required). Returns: object

cancel_firmware_validationB

取消验证后续步骤,不强杀正在写 Flash 的升级器;若已开始采集可等本次结束,不重复烧录。

Inputs: job_id (required). Returns: object

capture_oscilloscopeA
Destructive

用户选定 1~4 个 P 通道后执行 E1/E2 连续示波器采集,立即触发。周期为 2ms 的整数倍,最多 40 秒/20000 点;会清除旧示波器缓冲区,结束发送停止并导出原始/换算 CSV。无设备时间戳,不能保证无丢点;不控制电机。

Inputs: codes (required), points (required), sample_period_ms (required), port, +1 more. Returns: object

compare_device_parameter_snapshotsB
Read-onlyIdempotent

离线比较两份实机备份,分别报告数值变化、定义变化、新增和缺失;标明设备、版本及采集范围是否一致。缺失项只报告,不恢复默认值,不写设备。

Inputs: target_id (required), baseline_id (required), limit, offset. Returns: object

compare_parameter_setsB
Read-onlyIdempotent

比较同一参数目录的两个离线参数集,列出新增、删除、修改。

Inputs: target_id (required), baseline_id (required), limit, offset. Returns: object

configure_drive_position_referenceA

停机读取反馈后保存本次MCP会话的坐标参考,不写驱动器、不执行回零。先询问是否把当前停止点设为软件零点;existing_device_zero使用用户已建立的设备坐标。默认指令脉冲;圈/角度须明确每圈指令脉冲数。可选同时提供最小/最大软件行程;省略时只防32位溢出,无机械限位。断电、复位、重新回零或MCP重启后须重建,不能声称已验证物理零点。

Inputs: zero_method (required), port, unit, transport, +4 more. Returns: object

create_device_parameter_snapshotA

只读设备实际配置并保存新的 JSON 备份:默认全部可读可写的非预留、非 P 参数;groups 可限定组,include_monitoring=true 才包含只读监控项。依据在线目录及实时 B1/C2,保存身份/版本、原始值、精确小数值和时间范围。逐项读取,非同一时刻快照;失败不发布完整备份,不写设备。当前格式不是 bnproj,尚不提供恢复下发。

Inputs: label (required), port, groups, transport, +1 more. Returns: object

create_parameter_setB

把用户提供的值保存为 MCP 离线 JSON 参数集;保留已有文件,不写入设备。

Inputs: set_id (required), values (required), catalog_id (required), note. Returns: object

discover_device_parameter_catalogA
Read-onlyIdempotent

只读刷新设备功能码目录:A/A1 身份与参数版本,B6 大组、B4 子组数量、B5 实际地址/参数数量/组名,再用 B1/B3 获取属性/名称。不依赖 bnproj。group 为空读取完整目录,也可指定 B05/P11 单组;返回摘要及本地完整目录路径,不读取全部当前值。身份引导当前支持 AN 平台 9,其他平台尚未适配。

Inputs: port, group, transport. Returns: object

execute_drive_position_moveA
Destructive

用户允许预览中的位移及临时配置后执行一次后台定位。重查坐标/反馈/配置并维持心跳,验证目标位置后OFF1停机释放并恢复设置;用现有运行状态和停止工具查询或中止。

Inputs: plan_id (required). Returns: object

execute_drive_runA
Destructive

仅在用户明确允许该计划实际运动时调用。申请 PC 控制权、发送带单位的速度和心跳;持续模式返回后台 job_id,用 get_drive_run_status 查询、stop_drive_pc_control 停止。限时模式结束 OFF1 停机后释放;失败不自动重试。

Inputs: plan_id (required). Returns: object

get_capabilitiesA
Read-onlyIdempotent

查询离线能力和可选只读探测配置;不会主动连接设备。

Inputs: no named parameters. Returns: object

get_device_parameter_snapshotB
Read-onlyIdempotent

分页查看已有实机备份的定义、原始值和精确工程值;这是备份时读数,不是当前值。

Inputs: snapshot_id (required), group, limit, offset. Returns: object

get_drive_run_statusA
Read-onlyIdempotent

读取持续运行任务的心跳记录、状态字、实际速度反馈、停止结果和进程状态;不另开设备连接。不填 ID 返回最近任务。缓存记录含时间,不能把旧记录当作当前运动状态。

Inputs: job_id. Returns: object

get_firmware_buildA
Read-onlyIdempotent

读取已登记编译产物并核对封存文件哈希,不联系设备。

Inputs: build_id (required). Returns: object

get_firmware_upgrade_statusA
Read-onlyIdempotent

读取烧录进度、Flash 读回校验和启动验证结果;不联系设备。不填 ID 时返回最近 MCP 任务,尚无任务时可查看此前独立脚本的实测记录,历史记录不代表新烧录。

Inputs: job_id. Returns: object

get_firmware_validation_statusB
Read-onlyIdempotent

查询验证阶段、手动重启等待、错误及完整采集/统计报告,不联系设备。completed 表示数据准备好,仍须结合源码分析原因。

Inputs: job_id. Returns: object

get_network_selectionA
Read-onlyIdempotent

查看当前保存的网络设备选择;选择状态不表示设备在线。

Inputs: no named parameters. Returns: object

get_parameter_definitionC
Read-onlyIdempotent

读取指定功能码的参考定义;出厂值不是实时值,通讯地址尚未验证。

Inputs: code (required), catalog_id (required). Returns: object

get_parameter_setB
Read-onlyIdempotent

读取一个离线参数集;不代表设备实时参数。

Inputs: set_id (required). Returns: object

get_release_interfacesC
Read-onlyIdempotent

查询主程序的静态接口元数据;没有实例化或调用原软件通信方法。

Inputs: type_query. Returns: object

inspect_serial_deviceA
Read-onlyIdempotent

新串口产品的只读检查,支持 CM55 平台3及 AN 平台9,460800/8N1。identity 只读通用 A/A1 握手;catalog 按设备 B6/B4/B5/B1/B3 读取并分页搜索实际定义;read 先重新获取目录,再按实际地址读取1~20个功能码。不会沿用 AN 的 MAC/状态地址,不验证产品物理唯一身份,不使用旧缓存;不能写参数、采集、运行或烧录。

Inputs: mode, port, codes, group, +3 more. Returns: object

list_device_parameter_snapshotsB
Read-onlyIdempotent

列出本地实机参数备份的身份、范围、时间和数量,不联系设备。

Inputs: limit. Returns: object

list_network_interfacesA
Read-onlyIdempotent

列出可用于原扫描器同版 DCP 发现库的本机活动网卡、IPv4 和掩码;不会扫描或连接设备。

Inputs: no named parameters. Returns: object

list_oscilloscope_channelsB
Read-onlyIdempotent

只读核对设备身份/参数版本,分页列出设备在线目录中的可采 16 位 P 通道;支持名称/功能码搜索或 P00~P15 筛选,不依赖 AN380.bnproj,不启动采集。采集前再核对实时属性。

Inputs: port, group, limit, query, +2 more. Returns: object

list_parameter_catalogsA
Read-onlyIdempotent

列出发布包提取的参数目录;目录版本不代表测试设备型号已经匹配。

Inputs: no named parameters. Returns: result

list_parameter_setsA
Read-onlyIdempotent

列出 MCP 工作目录中的离线参数集。

Inputs: no named parameters. Returns: result

lookup_enum_valueB
Read-onlyIdempotent

在参数设定范围中查找显式枚举说明;返回参考含义,不判断实际故障原因。

Inputs: code (required), value (required), catalog_id (required). Returns: object

plan_batch_configurationB
Read-onlyIdempotent

预览批量修改及待验证项;文件中删除参数表示保留设备原值,当前不能执行。

Inputs: target_id (required), baseline_id (required), limit, offset. Returns: object

plan_drive_position_moveA

预览相对/绝对位置运动。先建立坐标及行程范围,速度为正整数rpm并受额定/在线JOG上限约束,加减速由驱动器处理。绝对目标按参考零点计算差值;列出临时模式及JOG参数变更,停机后恢复,可能写EEPROM。allow_mode_change须用户允许。默认等待定位完成后停止释放,可设超时且随时可停止;首版要求固定方向/电子齿轮选择。

Inputs: position (required), maximum_speed_rpm (required), local_stop_available (required), motor_load_description (required), +8… Returns: object

plan_drive_runA

预览速度运行,不启动。默认上限取当前电机额定/最大转速较小值,maximum_abs_speed可降低。自动选择固定16位编码,超过327.67rpm可用百分比给定,预览给出实际量化速度和分辨率。duration_s默认null持续运行,用户未说明时先询问持续或限时;长于20秒自动后台执行,有限时长最多2147483.647秒。需电机/负载、现场停机条件及B05.01=0;不自动切换模式,不生成外部斜坡。仅用户明确允许运行中反向时设置allow_direction_change。

Inputs: speed (required), port, transport, background, +7 more. Returns: object

preflight_firmware_upgradeA

只读预检生成 15 分钟一次性烧录计划,核对原升级器、MAC、平台、停止状态及运行位。旧固件可直接给路径;新编译产物先 register_firmware_build,再给 build_id、firmware_path=""。不开始升级。

Inputs: transport (required), firmware_path (required), port, build_id. Returns: object

prepare_device_parameter_writeC

只读预览一个参数的修改,value 为显示单位下的精确十进制字符串,生成 10 分钟有效的一次性计划;包含旧值、目标值和掉电保存影响,不实际写设备。

Inputs: code (required), value (required), port, transport. Returns: object

prepare_drive_speed_changeB

为当前后台速度会话预览调速,读取会话版本,不修改速度。允许零速保持会话,遵守该会话已授权速度/方向;显示实际量化给定,沿用内部斜坡。

Inputs: speed (required), job_id. Returns: object

prepare_firmware_validationA

离线预览一轮验证任务,绑定已登记产物、用户已选设备、问题/假设、采集通道/周期/点数、备份与重启等待时限。此时不接触设备。启动后单次烧录、等待用户手动重启、核对版本并刷新目录,自动备份/采集/统计。不会启动电机、改运行模式或自动重启;统计不等于根因诊断。

Inputs: points (required), problem (required), build_id (required), channels (required), +8 more. Returns: object

probe_device_read_onlyA
Read-onlyIdempotent

复用原软件读取参数版本、A02.00 软件版本、A00.00 状态及 C05.19~21 实际 MAC;460800/8N1,结束后关闭端口,不写参数。

Inputs: port. Returns: object

probe_selected_device_read_onlyA
Read-onlyIdempotent

对用户已选择的设备,通过原程序 TCP 1000 接口读版本、状态及 MAC,核对扫描 MAC 后返回;每次结束断开,不写参数。

Inputs: no named parameters. Returns: object

read_device_parametersA
Read-onlyIdempotent

按设备在线目录读取 1~20 个功能码的实时属性、上下限、名称和值,支持16/32位首字地址。AN核对MAC;CM55须先 select_serial_device,核对串口绑定/板号/平台;均核对参数版本/固件,不依赖导出工程。

Inputs: codes (required), port, transport. Returns: object

read_drive_motion_limitsB
Read-onlyIdempotent

只读当前激活电机数据组、在线额定/最大转速、频率和速度基准。适配器核对实时参数名称/格式;切换电机组或参数变化会使旧运动计划失效。

Inputs: port, transport. Returns: object

read_drive_position_statusB
Read-onlyIdempotent

只读位置反馈及坐标参考有效性;运行中复用心跳连接。未建立参考时仍可读原始指令脉冲反馈。

Inputs: port, transport. Returns: object

read_drive_runtime_statusB
Read-onlyIdempotent

只读状态机、控制字、状态字、PC 指令和速度/电流相关参数;不会取得控制权或启动电机。

Inputs: port, transport. Returns: object

register_firmware_buildA

登记编译产物:AN PN 9.10 用默认 profile/软件910;CM55 EC 6.12 用 cm55_ec_spi_612/软件612。校验产品封装、封存并记录 SHA-256 和用户声明的发布号/参数版本,不烧录;封装不能证明应用型号兼容。CM55 仅串口升级。

Inputs: label (required), firmware_path (required), expected_release_hex (required), profile, +3 more. Returns: object

reset_drive_faultA
Destructive

用户要求故障复位时,核对 MAC 和非运行状态后发送 PC 故障复位位的上升沿,再读回确认故障位清除。保持零给定,不申请控制权、不发送运行命令。故障条件未消除时失败,不自动重试。

Inputs: port, transport. Returns: object

scan_network_devicesA
Read-onlyIdempotent

在指定本机网卡执行 DCP Identify,只列出设备 IP/MAC/名称,不修改网络配置、不选择或连接设备;超时 2~15 秒。

Inputs: interface_ip (required), timeout_s. Returns: object

search_device_parametersA
Read-onlyIdempotent

搜索选中设备在线获取的功能码名称和属性,支持分组及分页。每次核对设备/参数版本;缺少目录时自动只读获取。返回字典身份、缓存时间和来源,不含当前值;当前值用 read_device_parameters。设备未提供枚举说明时不从其他型号补造。

Inputs: port, group, limit, query, +2 more. Returns: object

search_parametersB
Read-onlyIdempotent

按中文名称、功能码或说明搜索参考参数,分页返回原始字段及来源。

Inputs: query (required), limit, offset, catalog_id. Returns: object

select_network_deviceB

用户明确选定扫描列表中的设备后,保存其 IP/MAC/网卡;仅更新本地选择,不建立 TCP 连接。

Inputs: scan_id (required), device_id (required). Returns: object

select_serial_deviceA

绑定用户指定的 CM55 EC 6.12 串口:只读核对平台/软件/板号,保存本地选择,旧计划失效。现有参数、备份、采集及 rpm 运行工具使用 transport='serial'。CM55 无唯一UID,换机须重选。an_pn_910 可在核对原 COM7/已记录 AN MAC 后切回原串口配置。不写设备、不启动电机。

Inputs: port, profile. Returns: object

start_firmware_upgradeA
Destructive

仅在用户明确要求本次烧录后执行预检计划,实际擦写主控 Flash并返回 job_id。支持计划中的串口或选定 TCP 设备,复用原 F2/F1/F3;保持供电与连接,轮询结果,无自动重启。

Inputs: plan_id (required). Returns: object

start_firmware_validationA
Destructive

用户授权本轮预览后启动独立后台任务:预检并只烧录一次,等待手动重启,验证正确设备/固件后自动采集并生成报告。关闭 MCP 会话不终止任务;失败不会自动重刷,不控制电机。

Inputs: plan_id (required). Returns: object

stop_drive_pc_controlB
Destructive

停止 PC 控制并释放控制权;仅软件命令,不是安全急停,也不保证机械已停止。

Inputs: port, transport. Returns: object

summarize_waveformA
Read-onlyIdempotent

统计工作目录内已有 UTF-8 CSV 波形的范围、均值、RMS;时间列必须为秒。

Inputs: filename (required), time_column. Returns: object

verify_firmware_upgrade_bootA
Read-onlyIdempotent

用户完成手动断电重启后,只读核对已成功烧录任务的设备身份、版本和升级状态复位;不会发送重启或烧录命令。

Inputs: job_id (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 54 tools

    Disambiguation3/5

    The set is broadly divisible into firmware, parameter, network/serial, oscilloscope, and motion clusters, but several clusters contain easily confused neighbors: firmware validation versus firmware upgrade, offline parameter sets versus live device parameter catalogs versus device snapshots, and multiple read-only probe tools. Descriptions help, but an agent must carefully distinguish preview/start/status/verify phases and offline versus online parameter state.

    Naming Consistency5/5

    Tool names consistently use snake_case with a predictable verb_noun or verb_object_qualifier pattern, such as get_parameter_set, create_device_parameter_snapshot, prepare_drive_speed_change, and execute_drive_position_move. The naming style is stable across all clusters even where the tools themselves are complex.

    Tool Count2/5

    With 54 tools, the server is far beyond the typical well-scoped range and exposes many specialized lifecycle stages across firmware, parameters, networking, serial I/O, oscilloscope capture, and motion control. Even if each tool has a legitimate niche, the surface is heavy enough to make discovery and correct selection difficult.

    Completeness4/5

    Coverage is extensive: discovery, selection, read-only probing, parameter catalog/search/read/write planning, snapshots, firmware build/validation/upgrade status, oscilloscope capture, and motion planning/execution/status/stop are all represented. Minor gaps remain, such as no snapshot restore, no batch parameter write execution, and no deletion operations for offline parameter sets or snapshots, but these are mostly stated limitations rather than fatal omissions.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Exposes digital twin device data capabilities as MCP tools, allowing MCP clients to query device status, read real-time metrics, fetch time-series data, and check alerts. Includes a simulated PLC driver with a clean interface for connecting real devices via OPC-UA, Modbus, or gateway APIs.
      6
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to automate CODESYS V3 PLC development, including project editing, builds, library and alarm management, online variable read/write/force operations, and CODESYS documentation search via MCP.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables driving any installed CODESYS 3.5 version (SP18–SP22) from a single MCP server, automatically selecting the right install from each project file's saved version. Exposes 127 tools covering project and POU authoring, compile, online/runtime control, devices and tasks, symbol configuration, multi-device projects, and a version plus git release pipeline.
      5
      MIT