Postex MCP Server

🚀 PostEx MCP サーバー

このプロジェクトは、Model Context Protocol (MCP) サーバーを実装し、PostEx マーチャント API（v4.1.9）の様々なエンドポイントとのやり取りを可能にするツールを提供します。

🚀 クイックスタート

前提条件

• Node.js（LTS バージョンの使用を推奨）
• npm または yarn
• 有効な PostEx マーチャント API トークン

セットアップ

1. リポジトリをクローンする（該当する場合）か、index.js ファイルを用意します。
2. 依存関係をインストールします。

   npm install @modelcontextprotocol/sdk zod node-fetch@2 # require 構文と互換性を持つために v2 バージョンを使用
   # または
   yarn add @modelcontextprotocol/sdk zod node-fetch@2
   

3. PostEx API トークンを取得します。 PostEx マーチャントアカウントまたは担当者から取得してください。

サーバーの起動

Node.js を使用してサーバーを実行し、PostEx API トークンをコマンドライン引数として渡します。

node index.js <YOUR_POSTEX_API_TOKEN>

<YOUR_POSTEX_API_TOKEN> を実際のトークンに置き換えてください。

サーバーは標準入出力で接続し、状態メッセージを標準エラーに記録します。これで MCP リクエストを受け付ける準備ができました。

✨ 主な機能

サーバーは、PostEx API のエンドポイントに対応する以下のツールを公開しています。

• getOperationalCities：PostEx が運営している都市のリストを取得します。
• getMerchantAddress：マーチャントの登録された集荷住所を取得します。
• createMerchantAddress：マーチャントに新しい集荷住所を作成します。
• getOrderTypes：サポートされている注文タイプ（例：「通常」、「返品」）を取得します。
• createOrder：PostEx システムに新しい注文を作成します。
• getUnbookedOrders：指定された日付範囲内でまだ集荷予約されていない注文をリストします。
• trackOrder：追跡番号を使用して単一の注文を追跡します。
• trackBulkOrder：追跡番号のリストを使用して複数の注文を追跡します。（注意：API ドキュメントでは GET と指定されていますが、本文が必要です。最新のコード変更では GET を使用していますが、これは期待と異なる場合があります。）
• saveShipperAdvice：試行されたパッケージに対するアドバイス（例：再試行、返送）を提供します。
• getShipperAdvice：追跡番号のアドバイス履歴を取得します。
• cancelOrder：追跡番号を使用して注文をキャンセルします。（注意：PUT で JSON 本文を持つように実装されています。）
• getPaymentStatus：注文の決済ステータスを確認します。
• getOrderStatus：すべての可能な注文ステータスのリストを取得します。
• listOrders：指定された日付範囲内の注文をリストし、必要に応じてステータス ID でフィルタリングできます。

⚠️ 重要提示

このバージョンでは、PDF ファイルを返す generate-load-sheet や get-invoice などのツールは実装されていません。