Parcel MCP Server

小包や荷物の配送業務をシミュレートするモックMCP（Model Context Protocol）サーバーです。Salesforce Agentforceでの使用を想定しており、ドライバーや配送センターが受取人の問題を解決するために必要な一般的なアクションを網羅した12個のツールを公開しています。

ライブサーバー

Railwayでホストされており、常に稼働しているためセットアップは不要です。


ヘルスチェック	https://parcel-mcp-server-production.up.railway.app/health
MCPエンドポイント	https://parcel-mcp-server-production.up.railway.app/mcp
OAuthトークンURL	https://parcel-mcp-server-production.up.railway.app/oauth/token

このサーバーをSalesforce Agentforceレジストリに登録するには、以下の設定を使用してください。

フィールド	値
MCPサーバー名	Parcel MCP Server
サーバーURL	`https://parcel-mcp-server-production.up.railway.app/mcp`
認証方法	OAuth 2.0
IDプロバイダーURL	`https://parcel-mcp-server-production.up.railway.app/oauth/token`
スコープ	`read`
クライアントID	任意の値
クライアントシークレット	任意の値

OAuthエンドポイントはモックであり、任意のクライアントIDとシークレットを受け入れ、有効なベアラートークンを返します。

ツール	説明
`track_package`	追跡番号でステータス、場所の履歴、配送詳細を検索
`list_packages_for_driver`	ドライバーに割り当てられたすべての荷物をステータスと受取人情報とともに一覧表示
`update_delivery_status`	配送試行、例外、または完了を記録
`correct_delivery_address`	無効または配送不能な荷物に対して修正された住所を送信
`schedule_redelivery`	希望の日時枠を指定して再配達を予約
`request_hold_for_pickup`	受取人が受け取れるよう、最寄りの施設で荷物を保管
`initiate_return_to_sender`	理由コードを付けて荷物を返送対象としてマーク
`update_recipient_contact`	配送通知用の電話番号またはメールアドレスを更新
`report_damaged_package`	重大度レベルを指定して破損クレームを申請
`get_facility_info`	保管施設の営業時間、住所、アクセシビリティ情報を取得
`send_delivery_notification`	受取人にSMSまたはメール通知を送信
`get_route_summary`	ドライバーのルート統計（配達済み、保留中、例外）を取得

主な例外シナリオをカバーする4つの荷物がプリロードされています。

また、2人のドライバー DRV-101（ルートA）と DRV-102（ルートB）もプリロードされています。

npm installは不要です。サーバーはNode.jsの組み込み機能のみを使用します。

node server.js
# Server runs on http://localhost:3333

または、サーバーとngrokトンネルを同時に起動する付属のランチャーを使用してください。

bash launch.command

ランチャーは、パブリックなngrok URLとSalesforce接続設定を自動的に出力します。

server.js への変更は、以下で再デプロイできます。

railway up

Railway CLI がインストールされており、ログイン (railway login) していることを確認してください。

This server cannot be deployed