parcel-mcp

Parcel.app 配送追跡 API 用の MCP サーバーです。Claude（およびその他の MCP クライアント）から Parcel アカウント内の配送状況を確認したり、荷物を追加したりできます。

最新の parcellapp-mcp.dxt をダウンロード

ツール

list_deliveries

Parcel アカウントの配送リストを取得します。Parcel サーバーからキャッシュされたデータを返します。

• レート制限: 20 リクエスト/時間

• パラメータ:

  • filter_mode (任意): "active" (進行中のみ) または "recent" (デフォルト — アクティブ + 最近完了したもの)

add_delivery

Parcel アカウントに新しい配送を追加します。

• レート制限: 20 リクエスト/日 (失敗したリクエストを含む)

• パラメータ:

  • tracking_number (必須): 荷物の追跡番号

  • carrier_code (必須): Parcel 内部の配送業者コード — 配送業者リスト全体を参照してください。プレースホルダーには "pholder" を使用します。

  • description (必須): 配送のラベル

  • language (任意): ISO 639-1 の 2 文字コード。例: "en" (デフォルト), "de"

  • send_push_confirmation (任意): 追加時にプッシュ通知を受け取る場合は true (デフォルト false)

注意: 新しく追加された配送は、Parcel サーバーが最初に更新を行うまで「データなし」と表示されます。

前提条件

• Node.js 18+ (組み込みの fetch 用)

• API キーを持つ Parcel プレミアムアカウント — web.parcelapp.net で生成してください

セットアップ

git clone https://github.com/as-j/parcellapp-mcp.git
cd parcellapp-mcp
npm install
npm run build

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に以下を追加します：

{
  "mcpServers": {
    "parcel": {
      "command": "node",
      "args": ["/absolute/path/to/parcellapp-mcp/dist/index.js"],
      "env": {
        "PARCEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

保存後、Claude Desktop を再起動してください。

使用例

設定が完了すると、Claude に以下のように尋ねることができます：

• 「配送中の荷物はありますか？」

• 「アクティブな配送を表示して」

• 「追跡番号 1Z999AA10123456784、配送業者 UPS、説明 '新しいキーボード' で荷物を追加して」