parcel-mcp

用于 Parcel.app 递送追踪 API 的 MCP 服务器。允许 Claude（及其他 MCP 客户端）在您的 Parcel 账户中列出和添加包裹递送。

下载最新版 parcellapp-mcp.dxt

工具

list_deliveries

列出您 Parcel 账户中的递送信息。返回来自 Parcel 服务器的缓存数据。

• 速率限制： 20 次请求/小时

• 参数：

  • filter_mode (可选)："active"（仅进行中）或 "recent"（默认 — 进行中 + 最近完成）

add_delivery

向您的 Parcel 账户添加新的递送信息。

• 速率限制： 20 次请求/天（包含失败的请求）

• 参数：

  • tracking_number (必填)：包裹追踪号码

  • carrier_code (必填)：Parcel 内部承运商代码 — 请参阅 完整承运商列表。使用 "pholder" 作为占位符。

  • description (必填)：递送的标签

  • language (可选)：ISO 639-1 双字母代码，例如 "en"（默认）、"de"

  • send_push_confirmation (可选)：设为 true 以在添加时接收推送通知（默认 false）

注意： 新添加的递送信息在 Parcel 服务器首次更新之前会显示“无可用数据”。

前置要求

• Node.js 18+（用于内置 fetch）

• 拥有 API 密钥的 Parcel 高级账户 — 请在 web.parcelapp.net 生成

设置

git clone https://github.com/as-j/parcellapp-mcp.git
cd parcellapp-mcp
npm install
npm run build

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "parcel": {
      "command": "node",
      "args": ["/absolute/path/to/parcellapp-mcp/dist/index.js"],
      "env": {
        "PARCEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

保存后重启 Claude Desktop。

使用示例

配置完成后，您可以询问 Claude 诸如：

• “我有哪些包裹在运输中？”

• “显示我活跃的递送信息”

• “添加追踪号码 1Z999AA10123456784，承运商为 UPS，描述为 '新键盘'”