ProShip Thailand Post

proship-mcp

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

• エンドポイント： 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 のブラウザードキュメントページが、常に最新の正式なツールリファレンスです。

実行

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

環境変数

変数	用途	デフォルト
PORT	リッスンポート	3000
PUBLIC_URL	ラベル URL とドキュメントで使用する絶対ベース URL	https://mcp.proship.me
PROSHIP_API_BASE	上流 API のベース URL	https://api.proship.me
PROSHIP_UTRACK_TOKEN	認証なしの track_parcel を有効にする任意のサーバー側トークン	未設定
PROSHIP_SYNTH_EMAIL_DOMAIN	合成する登録メールアドレスのドメイン	proship.me

デプロイ

Fly.io アプリ proship-mcp（リージョン 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」と表示されていますが、配達中を意味します。
• サーバーの状態は、print_label が URL を返せるようにするための、ラベル PDF 用の 10 分間のインメモリーキャッシュのみです。