Skip to main content
Glama
deenesjakoruzh
ploughran

Parcel MCP Server

by ploughran
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

Parcel MCP Server

Ein Mock-MCP-Server (Model Context Protocol), der Abläufe für kleine Pakete und Sendungen simuliert. Er wurde für die Verwendung mit Salesforce Agentforce entwickelt und stellt 12 Tools bereit, die die gängigen Aktionen abdecken, die ein Fahrer oder ein Paketzentrum zur Behebung von Empfängerproblemen benötigt.

Live-Server

Gehostet auf Railway – immer verfügbar, keine Einrichtung erforderlich.

Health-Check

https://parcel-mcp-server-production.up.railway.app/health

MCP-Endpunkt

https://parcel-mcp-server-production.up.railway.app/mcp

OAuth-Token-URL

https://parcel-mcp-server-production.up.railway.app/oauth/token

Verbindung zur Salesforce Agentforce Registry

Um diesen Server in der Salesforce Agentforce Registry zu registrieren, verwenden Sie die folgenden Einstellungen:

Feld

Wert

MCP Server Name

Parcel MCP Server

Server-URL

https://parcel-mcp-server-production.up.railway.app/mcp

Authentifizierungsmethode

OAuth 2.0

Identitätsanbieter-URL

https://parcel-mcp-server-production.up.railway.app/oauth/token

Scope

read

Client-ID

beliebiger Wert

Client-Secret

beliebiger Wert

Der OAuth-Endpunkt ist ein Mock – er akzeptiert jede Client-ID und jedes Secret und gibt ein gültiges Bearer-Token zurück.

Tools

Tool

Beschreibung

track_package

Status, Standortverlauf und Zustellungsdetails anhand der Sendungsnummer abrufen

list_packages_for_driver

Alle einem Fahrer zugewiesenen Pakete mit Status und Empfängerinformationen auflisten

update_delivery_status

Zustellversuche, Ausnahmen oder Abschlüsse protokollieren

correct_delivery_address

Eine korrigierte Adresse für ein ungültiges oder unzustellbares Paket übermitteln

schedule_redelivery

Eine erneute Zustellung mit bevorzugtem Datum und Zeitfenster buchen

request_hold_for_pickup

Ein Paket zur Abholung durch den Empfänger in der nächstgelegenen Einrichtung hinterlegen

initiate_return_to_sender

Ein Paket mit einem Grundcode für die Rücksendung markieren

update_recipient_contact

Telefonnummer oder E-Mail-Adresse für Zustellbenachrichtigungen aktualisieren

report_damaged_package

Einen Schadensfall mit Schweregrad melden

get_facility_info

Öffnungszeiten, Adresse und Informationen zur Barrierefreiheit der Einrichtung abrufen

send_delivery_notification

SMS- oder E-Mail-Benachrichtigung an den Empfänger senden

get_route_summary

Routenstatistiken eines Fahrers abrufen – zugestellt, ausstehend, Ausnahmen

Mock-Daten

Es sind vier Pakete vorinstalliert, die die wichtigsten Ausnahmeszenarien abdecken:

Sendungsnummer

Status

Szenario

PKG-001

OUT_FOR_DELIVERY

Normale Zustellung läuft

PKG-002

DELIVERY_EXCEPTION

Adresse nicht gefunden, Problem mit der Klingel

PKG-003

HELD_AT_FACILITY

Maximale Versuche erreicht, wartet auf Abholung

PKG-004

PENDING_ADDRESS_CORRECTION

Ungültige Postleitzahl

Zwei Fahrer sind ebenfalls vorinstalliert: DRV-101 (Route A) und DRV-102 (Route B).

Lokal ausführen

Keine npm-Installation erforderlich – der Server verwendet nur Node.js-interne Funktionen.

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

Oder verwenden Sie den mitgelieferten Launcher, der den Server und einen ngrok-Tunnel zusammen startet:

bash launch.command

Der Launcher gibt automatisch Ihre öffentliche ngrok-URL und die Salesforce-Verbindungseinstellungen aus.

Erneutes Deployment auf Railway

Alle Änderungen an server.js können wie folgt neu bereitgestellt werden:

railway up

Stellen Sie sicher, dass die Railway CLI installiert ist und Sie angemeldet sind (railway login).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors