Parcel MCP Server

包裹MCP服务器

用于包裹递送跟踪API的MCP（模型上下文协议）服务器。此服务器允许AI助手与您的包裹帐户交互，以添加交付并跟踪其状态。

特性

此MCP服务器提供四种工具：

1. add_delivery

将新的配送添加到包裹中以进行跟踪。

参数：

• tracking_number （必填）：交货跟踪号
• carrier_code （必填）：承运商代码（例如，占位符为“ups”、“fedex”、“usps”、“pholder”）
• description （必填）：交货说明
• language （可选）：语言代码（ISO 639-1，例如“en”、“es”）。默认值：en
• send_push_confirmation （可选）：设置为true以接收推送通知。默认值：false

注： 速率限制为每天20个请求。

2. get_deliveries

从Parcel获取您最近或正在进行的配送。

参数：

• filter_mode （可选）：“活动”表示主动交付，“最近”表示最近交付。默认值：“最近”

注： 速率限制为每小时20个请求。

3. get_supported_carriers

获取支持的运营商及其代码列表。

无需参数。

4. get_delivery_status_codes

获取交货状态代码（0-8）的含义。

无需参数。

安装

先决条件

• 包裹保费账户
• 来自的API密钥 web.parcelapp.net

使用Smithery（推荐）

1. 使用Smithery CLI安装服务器：

smithery install parcel-mcp-server --client 

1. 在安装流程中，系统将提示您输入Parcel API密钥。

API密钥通过Smithery的配置系统安全地传递到服务器。

局部测试

对于本地开发和测试，服务器支持环境变量：

1. 克隆此存储库
2. 构建服务器：

npm install
npm run build

1. 添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "parcel": {
      "command": "node",
      "args": ["/path/to/parcel-mcp-server/dist/index.js"],
      "env": {
        "PARCEL_API_KEY": "your-api-key-here"
      }
    }
  }
}

注： 这 PARCEL_API_KEY 环境变量仅用于测试。生产部署应使用Smithery的配置流程。

发展

本地开发

npm install
npm run dev

这将使用Smithery的开发模式通过热重新加载启动服务器。

建筑

npm run build

API费率限制

• 添加交货：每天20个请求
• 获取交货：每小时20个请求

交付状态代码

• 0:已完成交付
• 1：冻结交货（没有最近的更新）
• 2：在途交货
• 3：预期收件人提货的交货
• 4：发货
• 5:未找到交货
• 6：交付尝试失败
• 7：交货异常（需要注意）
• 8：承运人已收到信息，但尚未收到实际包裹

资源

• 地块API文档-添加交付
• 地块API文档-查看交付
• 支持的运营商列表

许可证

麻省理工学院