UPS MCPサーバー

MIT License Node.js 20+ MCP TypeScript npm

UPS配送および物流API用のModel Context Protocolサーバーです。AIエージェントが配送の作成、荷物の追跡、料金の取得、住所の検証、集荷の予約、UPS拠点の検索を行えるようにします。

クイックインストール

MCP設定（~/.cursor/mcp.json、.cursor/mcp.json、または claude_desktop_config.json）に追加してください：

{
  "mcpServers": {
    "ups": {
      "command": "npx",
      "args": ["-y", "ups-mcp"],
      "env": {
        "UPS_CLIENT_ID": "your_client_id",
        "UPS_CLIENT_SECRET": "your_client_secret",
        "UPS_ACCOUNT_NUMBER": "123456",
        "UPS_ENVIRONMENT": "sandbox"
      }
    }
  }
}

UPS Developer Portalで認証情報を取得してください。

ツール

ツール	説明
`create_shipment`	配送を作成し、配送ラベルを生成する
`void_shipment`	配送をキャンセルし、ラベルを無効化する
`track_package`	完全なアクティビティ履歴で荷物を追跡する
`get_rates`	利用可能なすべてのサービスの配送料を取得する
`get_time_in_transit`	到着予定日を取得する
`validate_address`	米国/プエルトリコの住所を検証する
`schedule_pickup`	荷物の集荷を予約する
`cancel_pickup`	予約済みの集荷をキャンセルする
`find_locations`	近隣のUPSストアやドロップオフポイントを検索する

前提条件

Node.js 20以上
UPS Developer Portalの認証情報（開始方法）
UPSアカウント番号（配送および料金計算用）

インストール

npx ups-mcp

またはグローバルにインストール：

npm install -g ups-mcp

設定

環境変数

変数	必須	説明
`UPS_CLIENT_ID`	はい	UPS Developer PortalのOAuthクライアントID
`UPS_CLIENT_SECRET`	はい	OAuthクライアントシークレット
`UPS_ENVIRONMENT`	いいえ	`sandbox`（デフォルト）または `production`
`UPS_ACCOUNT_NUMBER`	いいえ	6桁のUPSアカウント（配送/料金計算に必要）

クライアント	設定ファイル
Cursor (プロジェクト)	`.cursor/mcp.json`
Cursor (グローバル)	`~/.cursor/mcp.json`
Claude Desktop	`claude_desktop_config.json`
VS Code	`.vscode/mcp.json`

使用例

配送の作成

"123 Main St, Atlanta GA 30301から456 Oak Ave, Los Angeles CA 90001まで、UPS Groundで5ポンドの荷物を発送して"

料金の取得

"NYCからシカゴまでの10ポンドの荷物の配送料はいくらですか？"

荷物の追跡

"荷物 1Z999AA10123456784 を追跡して"

住所の検証

"1600 Pennsylvania Ave NW, Washington DC 20500 は有効な住所ですか？"

集荷の予約

"明日午前9時に、倉庫にある3つの荷物の集荷を予約して"

開発

git clone https://github.com/roscoej/ups-mcp.git
cd ups-mcp
npm install
npm run build

MCP Inspectorでのテスト

npm run inspector

ローカルでの実行

cp .env.example .env
# Edit .env with your credentials
npm run build
node dist/index.js

アーキテクチャ

src/
├── index.ts            # Entry point (stdio transport)
├── config.ts           # Environment variable resolution
├── server.ts           # MCP server factory
├── client/
│   ├── auth.ts         # OAuth 2.0 token manager
│   ├── http.ts         # HTTP client with retry + error handling
│   └── errors.ts       # Structured error types
├── tools/
│   ├── tracking.ts     # track_package
│   ├── shipping.ts     # create_shipment, void_shipment
│   ├── rating.ts       # get_rates, get_time_in_transit
│   ├── address.ts      # validate_address
│   ├── pickup.ts       # schedule_pickup, cancel_pickup
│   ├── locator.ts      # find_locations
│   ├── builders.ts     # Shared request payload builders
│   ├── constants.ts    # UPS API codes and enumerations
│   └── schemas.ts      # Zod input schemas
└── types/
    ├── config.ts       # Server configuration
    ├── shipping.ts     # Shipment types + service codes
    ├── tracking.ts     # Tracking types
    ├── rating.ts       # Rating types
    ├── address.ts      # Address validation types
    └── pickup.ts       # Pickup types

セキュリティ

API認証情報は機密情報です。バージョン管理システムには絶対にコミットしないでください。環境変数またはシークレットマネージャーを使用してください。

免責事項

このプロジェクトは独立した非公式のサードパーティ製ツールです。United Parcel Service, Inc. (UPS) またはその子会社とは提携、推奨、後援されておらず、公式な関係もありません。

"UPS"およびUPSブランドマークは、United Parcel Service of America, Inc.の登録商標です。その他のすべての商標は、それぞれの所有者に帰属します。これらの名称の使用は、識別および相互運用性の目的のみであり、推奨を意味するものではありません。

本ソフトウェアは「現状のまま」提供され、いかなる種類の保証もありません。ユーザーは以下の事項について単独で責任を負うものとします：

UPS Technology Agreementおよび適用されるすべてのUPS利用規約、レート制限、および利用ポリシーの遵守。
API認証情報およびUPSアカウントの保護。
本ツールを通じてUPSアカウントで行われるすべてのアクティビティ。
居住管轄区域における適用されるすべての法律および規制の遵守。

作成者および貢献者は、本ソフトウェアまたは本ソフトウェアを通じてアクセスされるUPS APIの使用から生じる損害について、一切の責任を負いません。

貢献

貢献を歓迎します！ガイドラインについてはCONTRIBUTING.mdを参照してください。

ライセンス

MIT

UPS MCP Server