tlbm-mcp/README.md

TLBM MCP Server

TLBM 无人车运营 API 的 MCP 封装，支持 Hermes、Claude Code 等 AI Agent 直接调用运营接口。

功能

• 车辆状态查询：实时状态、不可用统计、工作时长指标、行驶距离
• 车辆轨迹回放：指定日期的轨迹和状态信息
• 运单监控：超时未确认装卸货查询
• 订单查询：运单汇总查询、订单数据分页查询
• 配置查询：开通城市列表

安装

方式一：一键安装（推荐）

curl -fsSL https://git.atomdancing.com/atomdancing.pub/tlbm-mcp/raw/branch/main/install.sh | bash

方式二：从源码安装

git clone gitea@git.atomdancing.com:atomdancing.pub/tlbm-mcp.git
cd tlbm-mcp
npm install
npm run build
npm link

更新

一键更新

curl -fsSL https://git.atomdancing.com/atomdancing.pub/tlbm-mcp/raw/branch/main/install.sh | bash

手动更新

cd tlbm-mcp
git pull
npm install
npm run build

注意：更新后需重启 MCP 客户端（Hermes / Claude Code）才能生效。

配置

Hermes Agent

在 ~/.hermes/config.yaml 中添加：

mcp_servers:
  tlbm:
    command: npx
    args: ["-y", "tlbm-mcp"]
    env:
      TLBM_API_URL: "https://www.atomdancing.com/pm"
      TLBM_TOKEN: ""  # 可选，用于用户认证

Claude Code / Claude Desktop

在 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "tlbm": {
      "command": "npx",
      "args": ["-y", "tlbm-mcp"],
      "env": {
        "TLBM_API_URL": "https://www.atomdancing.com/pm",
        "TLBM_TOKEN": ""
      }
    }
  }
}

工具列表

工具名	功能	备注
mcp_tlbm_list_vehicle_status	查询所有车辆最新状态	支持满满、自营
mcp_tlbm_get_vehicle_status	查询指定车辆状态	支持满满、自营
mcp_tlbm_list_vehicle_by_status	按状态码筛选车辆	仅支持满满
mcp_tlbm_get_vehicle_metrics	查询工作时长指标	仅支持满满
mcp_tlbm_get_vehicle_unavailability	统计不可用时长
mcp_tlbm_list_vehicle_unavailability	所有车辆不可用统计	仅支持满满
mcp_tlbm_get_vehicle_drive_mile	统计行驶距离	仅支持满满
mcp_tlbm_get_vehicle_path_playback	轨迹回放
mcp_tlbm_list_vehicle_heartbeat	查询车辆心跳数据
mcp_tlbm_get_overdue_shipping	查询超时未确认装卸货
mcp_tlbm_get_order_summary	查询运单汇总	仅支持满满
mcp_tlbm_get_today_orders	当日运单列表	仅支持满满
mcp_tlbm_get_orders_by_date	指定日期运单	仅支持满满
mcp_tlbm_get_unfinished_orders	未完成运单	仅支持满满
mcp_tlbm_query_orders	订单数据分页查询	仅支持自营
mcp_tlbm_get_open_cities	获取开通城市列表

车辆状态码说明

状态码	状态名称
0	关机
1	开机
2	任务中
3	故障
4	充电中
5	不可接单
6	OTA升级中
71	有任务装货开门
72	有任务卸货开门
8	非营运时间

使用示例

重启 Hermes 后，直接对话即可调用：

用户：查询所有车辆状态
Hermes：[调用 mcp_tlbm_list_vehicle_status]
        京A12345 电量85% 任务中...
        京B67890 电量42% 充电中...

用户：查看京A12345今天的轨迹
Hermes：[调用 mcp_tlbm_get_vehicle_path_playback]
        09:00 从起点出发...
        10:30 到达终点...

用户：有哪些未完成的订单？
Hermes：[调用 mcp_tlbm_get_unfinished_orders]
        OUT20260318001 运送中...

发布

npm login
npm publish --access public

License

Apache-2.0