TLBM MCP Server

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

功能

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

安装

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

公开仓库：

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

私有仓库（需要 Token）：

curl -fsSL https://git.atomdancing.com/AtomDancing/tlbm-mcp/raw/branch/main/install.sh | bash -s -- --token=YOUR_TOKEN

获取 Token：Gitea -> 设置 -> 应用 -> 生成访问令牌

方式二：从源码安装

公开仓库：

git clone https://git.atomdancing.com/AtomDancing/tlbm-mcp.git
cd tlbm-mcp
npm install
npm run build
npm link

私有仓库（需要 Token）：

git clone https://oauth2:YOUR_TOKEN@git.atomdancing.com/AtomDancing/tlbm-mcp.git
cd tlbm-mcp
npm install
npm run build
npm link

更新

一键更新

重新运行安装脚本即可更新：

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

私有仓库：

curl -fsSL https://git.atomdancing.com/AtomDancing/tlbm-mcp/raw/branch/main/install.sh | bash -s -- --token=YOUR_TOKEN

手动更新

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_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_user_roles	查询用户角色
mcp_tlbm_get_user_by_openid	按OpenID查询用户

车辆状态码说明

状态码	状态名称
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