FBox MCP Server 技能
通过 MCP 工具管理 FBox 工业物联网设备。安装和配置详见 README.md。
核心规则
数据真实性
- 所有数据必须来自工具调用的实时返回，禁止凭记忆、推测或编造任何设备信息、数值或状态
- 不得复用之前对话中获取的数据作为当前结果，每次查询必须重新调用工具
- 如果工具调用失败或返回异常，如实告知用户，禁止用虚构数据填充
时间处理
- 服务端所有时间均为 UTC 时间
- 展示给用户时必须转为北京时间（UTC+8），仅精确到秒
- 禁止假设当前时间，必须通过
utc_now工具获取服务器实时时间 - 历史数据和报警历史中的
Timestamp为 UTC 毫秒级时间戳
参数处理
BoxNo（设备序列号）和BoxAlias（设备别名）二选一即可定位设备- 用户说出的设备名称优先作为
BoxAlias传入 - 缺少必填参数时设为
null调用工具，服务端会返回候选列表 - 禁止自动猜测或补全参数，必须从候选列表中让用户选择
在线设备优先
- 除非用户明确说"所有设备"或"离线设备"，默认
OnlyOnline = true ConnState为Online或TimedOut视为在线
数据展示
bool值展示为"是"或"否"- 报警历史和历史数据默认以表格形式展示
- 监控点、报警、历史数据条目之间逻辑上没有强制关联性，不要假设名称一致
写操作安全
write_user_box_dmon_value和confirm_current_alarm是写操作- 必须获得用户明确确认后才能执行
- 写入前先读取当前值展示给用户对比
响应格式
所有业务工具返回统一结构：
{
"success": true,
"code": 0,
"message": null,
"data": { "..." },
"suggestedParameters": null
}
| Code | 含义 | 处理方式 |
|---|---|---|
| 0 | 成功 | 解析 data 展示给用户 |
| 300 | 参数需要选择 | 解析 suggestedParameters 候选列表让用户选择，选择后用 value 字段（非 label）重新调用 |
| 400 | 请求错误 | 展示 message 错误信息 |
| 401 | 未认证 | 提示用户检查认证配置 |
| 404 | 未找到 | 提示目标资源不存在 |
| 500 | 服务器错误 | 提示系统异常，建议稍后重试 |
典型工作流
设备状态概览
get_user_box_stats → get_user_box_list(OnlyOnline=true) → get_user_box_info(BoxAlias=xxx)
查看监控点数据
get_user_box_dmon_group_list(BoxAlias=xxx)
→ [如返回 300，让用户选择设备]
get_user_box_dmon_list(BoxNo=xxx, GroupName=xxx)
→ [如返回 300，让用户选择分组]
get_user_box_dmon_value(BoxNo=xxx, GroupName=xxx, Name=xxx)
处理设备报警
get_user_box_stats → 确认存在报警
get_current_alarm_list(BoxAlias=xxx) → 展示当前报警
confirm_current_alarm(BoxNo=xxx, AlarmName=xxx) → 用户确认后执行
查询历史趋势
utc_now → 获取服务器时间
get_history_data_define_list(BoxAlias=xxx) → 了解可查数据
get_history_data_list(BoxNo=xxx, ItemName=xxx, BeginTime=..., EndTime=...)
→ 以表格形式展示，时间转北京时间
写入监控点
get_user_box_dmon_value → 读取当前值展示给用户
→ 用户确认 "将 [监控点] 从 [当前值] 修改为 [目标值]"
write_user_box_dmon_value(Confirmed=true)