proship-mcp

ステートレスなMCP（Model Context Protocol）サーバー。任意のAIエージェントがThailand Postの配送を作成し、ラベルを印刷し、ProShipを通じて荷物を追跡できるようにします。

• エンドポイント: POST https://mcp.proship.me/mcp (JSON-RPC 2.0, application/json)

• ドキュメント: ブラウザで https://mcp.proship.me/mcp を開いてください — ドキュメントページはライブツールレジストリから生成されます。

• 認証: Authorization: Bearer <ProShip API token>、トークンはそのまま api.proship.me に渡されます。サーバーサイドには何も保存されません。新規ユーザーは公開ツール signup を呼び出してトークンを取得できます。

ツール

公開: track_parcel, get_order_statuses, signup。 認証済み: list_shops, create_order, list_orders, get_order, update_order_status, cancel_order, check_duplicate, print_label。

ブラウザのドキュメントページ（/mcp）は、常に最新のツールリファレンスです。

Related MCP server: shipsaving-mcp

実行

npm install
npm start          # listens on PORT (default 3000)
npm test           # node:test suite, upstream fully mocked

環境

デプロイ

Fly.io app proship-mcp (region sin):

fly deploy            # add --depot=false if the Depot builder fails

注意事項

• 注文IDはパイプサフィックスが付いています（order-xxx|123）。GET/PUT/DELETEは内部的にサフィックスを除去します。print_labelは完全なIDを必要とします。ツール間では常に完全なIDを渡してください。

• 重量はグラム単位です。ステータスコードはタイのパイプライン（get_order_statuses）を使用します。コード6は上流で「ERROR」とラベル付けされていますが、配達中を意味します。

• サーバーの状態は、ラベルPDF用の10分間のインメモリキャッシュのみであり、print_labelがURLを返せるようにしています。