Skip to main content
Glama
deenesjakoruzh
ploughran

Parcel MCP Server

by ploughran
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

Servidor MCP de Paquetería

Un servidor MCP (Model Context Protocol) simulado que recrea operaciones de paquetería pequeña. Diseñado para su uso con Salesforce Agentforce, expone 12 herramientas que cubren las acciones comunes que un conductor o un centro de procesamiento de paquetes necesitarían para solucionar problemas de los destinatarios.

Servidor en vivo

Alojado en Railway: siempre activo, no requiere configuración.

Comprobación de estado

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

Punto de conexión MCP

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

URL del token OAuth

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

Conexión al Registro de Salesforce Agentforce

Para registrar este servidor en el Registro de Salesforce Agentforce, utilice la siguiente configuración:

Campo

Valor

Nombre del servidor MCP

Parcel MCP Server

URL del servidor

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

Método de autenticación

OAuth 2.0

URL del proveedor de identidad

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

Ámbito (Scope)

read

ID de cliente

cualquier valor

Secreto de cliente

cualquier valor

El punto de conexión OAuth es simulado: acepta cualquier ID de cliente y secreto, y devuelve un token de portador (bearer token) válido.

Herramientas

Herramienta

Descripción

track_package

Busca el estado, el historial de ubicación y los detalles de entrega mediante el número de seguimiento

list_packages_for_driver

Enumera todos los paquetes asignados a un conductor con el estado y la información del destinatario

update_delivery_status

Registra intentos de entrega, excepciones o finalizaciones

correct_delivery_address

Envía una dirección corregida para un paquete no válido o no entregable

schedule_redelivery

Reserva una nueva entrega con la fecha y franja horaria preferidas

request_hold_for_pickup

Retiene un paquete en la instalación más cercana para que el destinatario lo recoja

initiate_return_to_sender

Marca un paquete para su devolución con un código de motivo

update_recipient_contact

Actualiza el teléfono o correo electrónico para las notificaciones de entrega

report_damaged_package

Presenta una reclamación por daños con nivel de gravedad

get_facility_info

Obtiene el horario, la dirección y la información de accesibilidad de la instalación de retención

send_delivery_notification

Envía una notificación por SMS o correo electrónico al destinatario

get_route_summary

Obtiene las estadísticas de la ruta de un conductor: entregados, pendientes, excepciones

Datos simulados

Se han precargado cuatro paquetes que cubren los principales escenarios de excepción:

N.º de seguimiento

Estado

Escenario

PKG-001

OUT_FOR_DELIVERY

Entrega normal en curso

PKG-002

DELIVERY_EXCEPTION

Dirección no encontrada, problema con el timbre

PKG-003

HELD_AT_FACILITY

Se alcanzó el máximo de intentos, esperando recogida

PKG-004

PENDING_ADDRESS_CORRECTION

Código postal no válido

También se han precargado dos conductores: DRV-101 (Ruta A) y DRV-102 (Ruta B).

Ejecución local

No se requiere npm install: el servidor utiliza solo funciones integradas de Node.js.

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

O utilice el lanzador incluido que inicia el servidor y un túnel ngrok juntos:

bash launch.command

El lanzador imprime automáticamente su URL pública de ngrok y la configuración de conexión de Salesforce.

Despliegue en Railway

Cualquier cambio en server.js puede volver a desplegarse con:

railway up

Asegúrese de tener instalada la CLI de Railway y de haber iniciado sesión (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