Skip to main content
Glama
ploughran

Parcel MCP Server

by ploughran

包裹 MCP 服务器

一个模拟小型包裹和快递操作的 MCP(模型上下文协议)服务器。专为 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

身份提供商 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

向收件人发送短信或电子邮件通知

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 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)。

Related MCP Connectors