Skip to main content
Glama
deenesjakoruzh
ploughran

Parcel MCP Server

by ploughran
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

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

URL OAuth-токена

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

Подключение к реестру Salesforce Agentforce

Чтобы зарегистрировать этот сервер в реестре Salesforce Agentforce, используйте следующие настройки:

Поле

Значение

Имя MCP-сервера

Parcel MCP Server

URL сервера

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

Метод аутентификации

OAuth 2.0

URL поставщика идентификации

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

Область действия (Scope)

read

Идентификатор клиента (Client ID)

любое значение

Секрет клиента (Client Secret)

любое значение

Эндпоинт OAuth является имитационным — он принимает любой идентификатор и секрет клиента и возвращает действительный токен доступа (bearer token).

Инструменты

Инструмент

Описание

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

Получение статистики маршрута водителя — доставлено, в ожидании, исключения

Имитационные данные

Предварительно загружены четыре посылки, охватывающие основные сценарии исключений:

Номер отслеживания

Статус

Сценарий

PKG-001

OUT_FOR_DELIVERY

Обычная доставка в процессе

PKG-002

DELIVERY_EXCEPTION

Адрес не найден, проблема с домофоном

PKG-003

HELD_AT_FACILITY

Достигнуто максимальное количество попыток, ожидается самовывоз

PKG-004

PENDING_ADDRESS_CORRECTION

Неверный почтовый индекс

Также предварительно загружены два водителя: DRV-101 (Маршрут A) и DRV-102 (Маршрут B).

Локальный запуск

Установка через npm не требуется — сервер использует только встроенные средства Node.js.

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

Или используйте включенный лаунчер, который запускает сервер и туннель ngrok одновременно:

bash launch.command

Лаунчер автоматически выводит ваш публичный URL ngrok и настройки подключения к Salesforce.

Повторное развертывание на Railway

Любые изменения в server.js можно развернуть повторно с помощью:

railway up

Убедитесь, что у вас установлен Railway CLI и вы вошли в систему (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