royalmail-mcp 是一个开源 MCP 服务器，用于让任何支持 MCP 的 AI 客户端（如 Claude、Cursor、Windsurf）直接操作 Royal Mail 和 Parcelforce 的寄送流程。它通过 Click & Drop API 密钥与 https://api.parcel.royalmail.com/api/v1 通信，向 AI 暴露六个工具，覆盖预订、生成面单、追踪和取消等操作。项目已针对实时 Click & Drop API 进行验证（2026 年 4 月），预订、追踪和取消功能经过端到端测试，面单获取则依据 OBA 账户规范验证。
主要能力：AI 可处理地址解析、服务选择与错误恢复，用户负责业务决策。支持的服务包括一等邮件、Tracked 48、Special Delivery by 1pm、Royal Mail Tracked 24 等，另有 22 种以上服务，涵盖签收变体、年龄验证服务和 Parcelforce 国际服务。可通过 list_services 获取完整列表。服务参数可传友好键（如 first-class）或原始 Service Register 代码（如 OLP1），具体可用服务取决于 Click & Drop 中启用的运输服务。
使用方式：支持 stdio 传输的 MCP 客户端均可使用。安装后，用户可用自然语言提示 AI 执行操作，例如预订一等信件、批量下单并获取合并 PDF、取消订单、查询最便宜的签收服务、追踪多个订单等。API 密钥需从 Click & Drop → Settings → API credentials 获取，可放在 .env 文件或 MCP 客户端配置中。Claude 桌面版配置路径为 ~/Library/Application Support/Claude/claude_desktop_config.json，Cursor 为 ~/.cursor/mcp.json。也可不安装直接运行。
适用场景：可接入 AI 代理实现每日订单履行（从 Shopify、WooCommerce 或表格读取订单并回传追踪号）、客服查询（追踪包裹并起草回复）、退货处理（预订退货服务并邮件发送面单）、多承运商比价（与 apc-mcp 配合）、批量履行（处理 CSV 中的数百订单）以及结账时运费报价。
限制与注意事项：面单获取（get_label）仅适用于 Royal Mail Online Business Account（OBA）客户，标准按需付费账户会收到 403 Forbidden。预订、追踪和取消适用于所有账户类型。OBA 用户需在 Click & Drop → Settings 中勾选“Apply postage automatically on orders imported via API”，否则订单保持草稿状态，get_label 会返回错误。API 密钥拥有账户完全访问权限，应像密码一样保管，切勿提交到 git 或粘贴到聊天中。ChatGPT、Smithery 等仅支持远程的 MCP 客户端需要 HTTP 传输，目前尚未包含。
隐私与数据处理：该 MCP 完全在用户机器上运行，作者不运营任何服务器接收客户数据、凭证或 API 流量。数据路径为：用户提供给 AI 助手的运输详情发送至 AI 提供商（如 Anthropic）；预订请求通过 API 密钥发送至 Royal Mail Click & Drop；面单保存至本地 ~/Downloads/parcel-toolkit/（可通过 PARCEL_TOOLKIT_LABELS_DIR 环境变量覆盖）。英国企业用户作为数据控制者需遵守 UK GDPR，建议使用 Claude Team、Enterprise 或 API 而非消费者版，并在隐私政策中将 Anthropic 和 Royal Mail 列为子处理者。
项目采用 MIT 许可，与 Royal Mail Group Ltd 无关联、未获其背书或赞助。“Royal Mail”、“Parcelforce”和“Click & Drop”是其各自所有者的商标。使用风险自负。
