Parcel Tracking MCP

🚀 パーセル追跡MCPサーバー

17track.net APIを使用してパーセル配送を追跡するためのモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• 様々な運送会社のパーセル配送を追跡できます。
• 運送会社を自動検出します。
• 手動で運送会社を指定することもサポートしています。
• TypeScriptとMCP SDKで構築されています。

📦 インストール

前提条件

• Node.js (v16以上)
• npmまたはyarn
• 17track.net APIトークン

インストール手順

グローバルにインストールするには、以下のコマンドを実行します。

npm install -g parcel-tracking-mcp-server

ローカルにインストールするには、以下のコマンドを実行します。

npm install parcel-tracking-mcp-server

設定

作業ディレクトリにconfig.jsonファイルを作成し、17track.net APIトークンを追加します。

{
  "apiToken": "your-17track-api-token-here"
}

注意: サーバーはコマンドを実行するカレントワーキングディレクトリ内のconfig.jsonを探します。

17track.net APIトークンの取得方法

1. 17track.netにアクセスします。
2. アカウントを登録します。
3. APIセクションに移動します。
4. APIトークンを生成します。
5. 生成したトークンをconfig.jsonファイルに追加します。

💻 使用例

サーバーの起動

グローバルにインストールした場合、以下のコマンドでサーバーを起動します。

parcel-tracking-mcp-server

ローカルにインストールした場合、以下のコマンドでサーバーを起動します。

npx parcel-tracking-mcp-server

または、プロジェクトの依存関係として使用する場合は、以下のコマンドを実行します。

node node_modules/parcel-tracking-mcp-server/dist/index.js

MCPクライアントの設定

このサーバーをMCPクライアント（Claude Desktopなど）で使用するには、MCP設定に追加します。

ローカルにインストールした場合:

{
  "mcpServers": {
    "parcel-tracking": {
      "command": "npx",
      "args": ["parcel-tracking-mcp-server"]
    }
  }
}

グローバルにインストールした場合:

{
  "mcpServers": {
    "parcel-tracking": {
      "command": "parcel-tracking-mcp-server"
    }
  }
}

利用可能なツール

tracking-delivery

追跡番号を指定してパーセル配送を追跡します。

パラメーター:

• number (必須): パーセルの追跡番号
• carrier (オプション): パーセルの運送会社（デフォルトは自動検出の 'auto'）

例:

// 自動運送会社検出で追跡
await trackingDelivery({
  number: "1234567890"
});

// 特定の運送会社で追跡
await trackingDelivery({
  number: "1234567890",
  carrier: "ups"
});

サポートされる運送会社

サーバーは運送会社の自動検出をサポートしていますが、手動で指定することもできます。一般的な運送会社には以下のものが含まれます。

• UPS
• FedEx
• DHL
• USPS
• 中国郵便
• その他多数（完全なリストは17track.netのドキュメントを確認してください）

📚 詳細ドキュメント

APIレスポンス形式

サーバーは追跡情報をJSON形式で返します。以下の情報が含まれます。

• 追跡ステータス
• 配送進捗
• タイムスタンプ
• 位置情報の更新
• 運送会社情報

エラーハンドリング

サーバーには包括的なエラーハンドリングが組み込まれています。

• API接続エラー
• 無効な追跡番号
• 設定の欠落
• ネットワークタイムアウト

🔧 技術詳細

プロジェクト構造

├── index.ts          # メインサーバーの実装
├── config.json       # 設定ファイル（これを作成する）
├── package.json      # 依存関係とスクリプト
└── README.md         # このファイル

依存関係

• @modelcontextprotocol/sdk - サーバー構築用のMCP SDK
• zod - スキーマ検証
• node-fetch - HTTPリクエスト（古いNode.jsバージョンで必要な場合）

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

サポート

• MCPプロトコルに関する問題: MCPドキュメントを確認してください。
• 17track.net APIに関する問題: 17track.net APIドキュメントを参照してください。
• この実装に関する問題: リポジトリにイシューを作成してください。

変更履歴

v1.0.0

• 初期リリース
• 基本的なパーセル追跡機能
• 自動および手動の運送会社検出のサポート
• エラーハンドリングとロギング