Skip to main content
Glama
Parcel MCP Server

Parcel MCP Server

by ploughran

Parcel MCP Server

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

ライブサーバー

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

Salesforce Agentforceレジストリ接続

このサーバーを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つの荷物がプリロードされています。

追跡番号

ステータス

シナリオ

PKG-001

OUT_FOR_DELIVERY

通常配送中

PKG-002

DELIVERY_EXCEPTION

住所が見つからない、ブザーの問題

PKG-003

HELD_AT_FACILITY

最大試行回数に到達、受取待ち

PKG-004

PENDING_ADDRESS_CORRECTION

無効な郵便番号

また、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接続設定を自動的に出力します。

Railwayへの再デプロイ

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

railway up

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors