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の動作

リクエストは共通パラメータ、アクセストークン、大文字のUTF-8 MD5署名を持つ POST /route/rest を使用します。トークンは 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 を参照してください。