Witzense MCP

用于 API DOCUMENT.pdf 中描述的 Witzense/JIMI 设备追踪 Open API 的 MCP 服务器。

提取的 Markdown 参考文档是 API DOCUMENT.md。它以页面分节的形式保留了全部 126 个 PDF 页面，更易于搜索和以编程方式处理。PDF 仍是原始来源，纯图片内容未嵌入到 Markdown 提取结果中。

配置

将 .env.example 复制为本地环境配置并设置：

• WITZENSE_BASE_URL：默认为 http://open.10000track.com/route/rest。

• WITZENSE_APP_KEY 和 WITZENSE_APP_SECRET。

• WITZENSE_ACCOUNT 和 WITZENSE_PASSWORD_MD5 — 账户密码现有的 32 位小写 MD5；不要提供明文，也不要再次对该值进行哈希。

• WITZENSE_EXPIRES_IN：请求的令牌有效期，范围为 60 到 7200 秒。

• WITZENSE_REQUEST_ENCODING：默认为 form，如果分配的节点要求，则使用 json。

切勿提交真实凭据，也不要将其放入源文件中。

Related MCP server: SORACOM Data Reader MCP

运行

npm install
npm run build
npm start

服务器通过 MCP stdio 进行通信。可用工具包括：

• call_witzense_method

• list_witzense_child_accounts

• list_witzense_devices

• get_witzense_device

• get_witzense_device_locations

• list_witzense_account_locations

• get_witzense_track

• get_witzense_mileage

• get_witzense_shared_location_url

• list_witzense_alarms

• get_witzense_parking_report

• get_witzense_trips_report

• get_witzense_fence_duration_report

• get_witzense_obd_data

• get_witzense_obd_faults

• get_witzense_rfid_reports

• get_witzense_tag_location

• list_witzense_geofences

• get_witzense_geofence

• list_witzense_device_groups

• get_witzense_media_urls

• get_witzense_live_url

• get_witzense_rtmp_url

这些专用工具面向读取操作，并使用共享的签名客户端。

对于 Command Cloud 集成，每个 Witzense 设备/IMEI 都被视为对应的 Command Cloud 资产/车辆。参见 specs/commandcloud-mapping.md。

API 行为

请求使用 POST /route/rest，包含公共参数、访问令牌以及大写 UTF-8 MD5 签名。令牌通过 jimi.oauth.token.get 获取，通过 jimi.oauth.token.refresh 刷新，并缓存在内存中。

PDF 列出了 TS、TSP HK、TSP EU 和 TSP US 节点。通过 WITZENSE_BASE_URL 配置分配的节点；在节点之间切换时不要更改工具代码。

测试

npm test

服务器部署

仓库工作流会构建并测试拉取请求，然后在推送到 main 后部署 /root/WITZENSE-MCP。使用 root@2.25.109.42 接受的部署密钥配置 GitHub Actions 机密 DEPLOY_SSH_KEY。

将 Witzense API 变量保留在服务器的运行时环境或 MCP 主机配置中。它们有意不包含在部署工作流或仓库中。

参见 DEPLOYMENT.md 了解首台服务器的引导和冒烟测试命令。