BonengDriveMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BONENG_DATA_DIR | Yes | Path to the BonengDriveMCP data directory. | |
| BONENG_PWSH_PATH | Yes | Path to the PowerShell 7 executable, for example the path returned by Get-Command pwsh. | |
| BONENG_WORKSPACE | Yes | Path to the BonengDriveMCP workspace directory. | |
| BONENG_SERIAL_MAC | No | User-verified MAC address required for AN serial use; the current old adapter is limited to COM7. CM55 does not require the AN MAC. | |
| BONENG_RELEASE_DIR | Yes | Path to the checked Drivesoft V1.28 test release/vendor software directory used for real-device communication and bridge building. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_capabilitiesA | 查询离线能力和可选只读探测配置;不会主动连接设备。 |
| probe_device_read_onlyA | 复用原软件读取参数版本、A02.00 软件版本、A00.00 状态及 C05.19~21 实际 MAC;460800/8N1,结束后关闭端口,不写参数。 |
| inspect_serial_deviceA | 新串口产品的只读检查,支持 CM55 平台3及 AN 平台9,460800/8N1。identity 只读通用 A/A1 握手;catalog 按设备 B6/B4/B5/B1/B3 读取并分页搜索实际定义;read 先重新获取目录,再按实际地址读取1~20个功能码。不会沿用 AN 的 MAC/状态地址,不验证产品物理唯一身份,不使用旧缓存;不能写参数、采集、运行或烧录。 |
| select_serial_deviceA | 绑定用户指定的 CM55 EC 6.12 串口:只读核对平台/软件/板号,保存本地选择,旧计划失效。现有参数、备份、采集及 rpm 运行工具使用 transport='serial'。CM55 无唯一UID,换机须重选。an_pn_910 可在核对原 COM7/已记录 AN MAC 后切回原串口配置。不写设备、不启动电机。 |
| list_network_interfacesA | 列出可用于原扫描器同版 DCP 发现库的本机活动网卡、IPv4 和掩码;不会扫描或连接设备。 |
| scan_network_devicesA | 在指定本机网卡执行 DCP Identify,只列出设备 IP/MAC/名称,不修改网络配置、不选择或连接设备;超时 2~15 秒。 |
| select_network_deviceB | 用户明确选定扫描列表中的设备后,保存其 IP/MAC/网卡;仅更新本地选择,不建立 TCP 连接。 |
| get_network_selectionA | 查看当前保存的网络设备选择;选择状态不表示设备在线。 |
| probe_selected_device_read_onlyA | 对用户已选择的设备,通过原程序 TCP 1000 接口读版本、状态及 MAC,核对扫描 MAC 后返回;每次结束断开,不写参数。 |
| register_firmware_buildA | 登记编译产物:AN PN 9.10 用默认 profile/软件910;CM55 EC 6.12 用 cm55_ec_spi_612/软件612。校验产品封装、封存并记录 SHA-256 和用户声明的发布号/参数版本,不烧录;封装不能证明应用型号兼容。CM55 仅串口升级。 |
| get_firmware_buildA | 读取已登记编译产物并核对封存文件哈希,不联系设备。 |
| prepare_firmware_validationA | 离线预览一轮验证任务,绑定已登记产物、用户已选设备、问题/假设、采集通道/周期/点数、备份与重启等待时限。此时不接触设备。启动后单次烧录、等待用户手动重启、核对版本并刷新目录,自动备份/采集/统计。不会启动电机、改运行模式或自动重启;统计不等于根因诊断。 |
| start_firmware_validationA | 用户授权本轮预览后启动独立后台任务:预检并只烧录一次,等待手动重启,验证正确设备/固件后自动采集并生成报告。关闭 MCP 会话不终止任务;失败不会自动重刷,不控制电机。 |
| get_firmware_validation_statusB | 查询验证阶段、手动重启等待、错误及完整采集/统计报告,不联系设备。completed 表示数据准备好,仍须结合源码分析原因。 |
| cancel_firmware_validationB | 取消验证后续步骤,不强杀正在写 Flash 的升级器;若已开始采集可等本次结束,不重复烧录。 |
| preflight_firmware_upgradeA | 只读预检生成 15 分钟一次性烧录计划,核对原升级器、MAC、平台、停止状态及运行位。旧固件可直接给路径;新编译产物先 register_firmware_build,再给 build_id、firmware_path=""。不开始升级。 |
| start_firmware_upgradeA | 仅在用户明确要求本次烧录后执行预检计划,实际擦写主控 Flash并返回 job_id。支持计划中的串口或选定 TCP 设备,复用原 F2/F1/F3;保持供电与连接,轮询结果,无自动重启。 |
| get_firmware_upgrade_statusA | 读取烧录进度、Flash 读回校验和启动验证结果;不联系设备。不填 ID 时返回最近 MCP 任务,尚无任务时可查看此前独立脚本的实测记录,历史记录不代表新烧录。 |
| verify_firmware_upgrade_bootA | 用户完成手动断电重启后,只读核对已成功烧录任务的设备身份、版本和升级状态复位;不会发送重启或烧录命令。 |
| discover_device_parameter_catalogA | 只读刷新设备功能码目录:A/A1 身份与参数版本,B6 大组、B4 子组数量、B5 实际地址/参数数量/组名,再用 B1/B3 获取属性/名称。不依赖 bnproj。group 为空读取完整目录,也可指定 B05/P11 单组;返回摘要及本地完整目录路径,不读取全部当前值。身份引导当前支持 AN 平台 9,其他平台尚未适配。 |
| search_device_parametersA | 搜索选中设备在线获取的功能码名称和属性,支持分组及分页。每次核对设备/参数版本;缺少目录时自动只读获取。返回字典身份、缓存时间和来源,不含当前值;当前值用 read_device_parameters。设备未提供枚举说明时不从其他型号补造。 |
| read_device_parametersA | 按设备在线目录读取 1~20 个功能码的实时属性、上下限、名称和值,支持16/32位首字地址。AN核对MAC;CM55须先 select_serial_device,核对串口绑定/板号/平台;均核对参数版本/固件,不依赖导出工程。 |
| create_device_parameter_snapshotA | 只读设备实际配置并保存新的 JSON 备份:默认全部可读可写的非预留、非 P 参数;groups 可限定组,include_monitoring=true 才包含只读监控项。依据在线目录及实时 B1/C2,保存身份/版本、原始值、精确小数值和时间范围。逐项读取,非同一时刻快照;失败不发布完整备份,不写设备。当前格式不是 bnproj,尚不提供恢复下发。 |
| list_device_parameter_snapshotsB | 列出本地实机参数备份的身份、范围、时间和数量,不联系设备。 |
| get_device_parameter_snapshotB | 分页查看已有实机备份的定义、原始值和精确工程值;这是备份时读数,不是当前值。 |
| compare_device_parameter_snapshotsB | 离线比较两份实机备份,分别报告数值变化、定义变化、新增和缺失;标明设备、版本及采集范围是否一致。缺失项只报告,不恢复默认值,不写设备。 |
| prepare_device_parameter_writeC | 只读预览一个参数的修改,value 为显示单位下的精确十进制字符串,生成 10 分钟有效的一次性计划;包含旧值、目标值和掉电保存影响,不实际写设备。 |
| apply_device_parameter_writeA | 用户明确指定本次参数和值后执行计划:重查设备/固件/旧值/属性,停机状态下写入单个参数并读回。可能保存 EEPROM;失败不自动重试。运行/重启命令使用专用流程。 |
| list_oscilloscope_channelsB | 只读核对设备身份/参数版本,分页列出设备在线目录中的可采 16 位 P 通道;支持名称/功能码搜索或 P00~P15 筛选,不依赖 AN380.bnproj,不启动采集。采集前再核对实时属性。 |
| capture_oscilloscopeA | 用户选定 1~4 个 P 通道后执行 E1/E2 连续示波器采集,立即触发。周期为 2ms 的整数倍,最多 40 秒/20000 点;会清除旧示波器缓冲区,结束发送停止并导出原始/换算 CSV。无设备时间戳,不能保证无丢点;不控制电机。 |
| read_drive_runtime_statusB | 只读状态机、控制字、状态字、PC 指令和速度/电流相关参数;不会取得控制权或启动电机。 |
| plan_drive_runA | 预览速度运行,不启动。默认上限取当前电机额定/最大转速较小值,maximum_abs_speed可降低。自动选择固定16位编码,超过327.67rpm可用百分比给定,预览给出实际量化速度和分辨率。duration_s默认null持续运行,用户未说明时先询问持续或限时;长于20秒自动后台执行,有限时长最多2147483.647秒。需电机/负载、现场停机条件及B05.01=0;不自动切换模式,不生成外部斜坡。仅用户明确允许运行中反向时设置allow_direction_change。 |
| read_drive_motion_limitsB | 只读当前激活电机数据组、在线额定/最大转速、频率和速度基准。适配器核对实时参数名称/格式;切换电机组或参数变化会使旧运动计划失效。 |
| prepare_drive_speed_changeB | 为当前后台速度会话预览调速,读取会话版本,不修改速度。允许零速保持会话,遵守该会话已授权速度/方向;显示实际量化给定,沿用内部斜坡。 |
| apply_drive_speed_changeA | 执行用户要求的单次调速,复用运行连接及心跳,优先于长采集;再次核对版本和电机参数并回读给定。给定回读成功不代表实际达速,失败不自动重试。 |
| configure_drive_position_referenceA | 停机读取反馈后保存本次MCP会话的坐标参考,不写驱动器、不执行回零。先询问是否把当前停止点设为软件零点;existing_device_zero使用用户已建立的设备坐标。默认指令脉冲;圈/角度须明确每圈指令脉冲数。可选同时提供最小/最大软件行程;省略时只防32位溢出,无机械限位。断电、复位、重新回零或MCP重启后须重建,不能声称已验证物理零点。 |
| read_drive_position_statusB | 只读位置反馈及坐标参考有效性;运行中复用心跳连接。未建立参考时仍可读原始指令脉冲反馈。 |
| plan_drive_position_moveA | 预览相对/绝对位置运动。先建立坐标及行程范围,速度为正整数rpm并受额定/在线JOG上限约束,加减速由驱动器处理。绝对目标按参考零点计算差值;列出临时模式及JOG参数变更,停机后恢复,可能写EEPROM。allow_mode_change须用户允许。默认等待定位完成后停止释放,可设超时且随时可停止;首版要求固定方向/电子齿轮选择。 |
| execute_drive_position_moveA | 用户允许预览中的位移及临时配置后执行一次后台定位。重查坐标/反馈/配置并维持心跳,验证目标位置后OFF1停机释放并恢复设置;用现有运行状态和停止工具查询或中止。 |
| execute_drive_runA | 仅在用户明确允许该计划实际运动时调用。申请 PC 控制权、发送带单位的速度和心跳;持续模式返回后台 job_id,用 get_drive_run_status 查询、stop_drive_pc_control 停止。限时模式结束 OFF1 停机后释放;失败不自动重试。 |
| get_drive_run_statusA | 读取持续运行任务的心跳记录、状态字、实际速度反馈、停止结果和进程状态;不另开设备连接。不填 ID 返回最近任务。缓存记录含时间,不能把旧记录当作当前运动状态。 |
| stop_drive_pc_controlB | 停止 PC 控制并释放控制权;仅软件命令,不是安全急停,也不保证机械已停止。 |
| reset_drive_faultA | 用户要求故障复位时,核对 MAC 和非运行状态后发送 PC 故障复位位的上升沿,再读回确认故障位清除。保持零给定,不申请控制权、不发送运行命令。故障条件未消除时失败,不自动重试。 |
| list_parameter_catalogsA | 列出发布包提取的参数目录;目录版本不代表测试设备型号已经匹配。 |
| search_parametersB | 按中文名称、功能码或说明搜索参考参数,分页返回原始字段及来源。 |
| get_parameter_definitionC | 读取指定功能码的参考定义;出厂值不是实时值,通讯地址尚未验证。 |
| lookup_enum_valueB | 在参数设定范围中查找显式枚举说明;返回参考含义,不判断实际故障原因。 |
| create_parameter_setB | 把用户提供的值保存为 MCP 离线 JSON 参数集;保留已有文件,不写入设备。 |
| list_parameter_setsA | 列出 MCP 工作目录中的离线参数集。 |
| get_parameter_setB | 读取一个离线参数集;不代表设备实时参数。 |
| compare_parameter_setsB | 比较同一参数目录的两个离线参数集,列出新增、删除、修改。 |
| plan_batch_configurationB | 预览批量修改及待验证项;文件中删除参数表示保留设备原值,当前不能执行。 |
| summarize_waveformA | 统计工作目录内已有 UTF-8 CSV 波形的范围、均值、RMS;时间列必须为秒。 |
| get_release_interfacesC | 查询主程序的静态接口元数据;没有实例化或调用原软件通信方法。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 54 tools
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.
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.
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.
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.