17TRACK Global Logistics Tracking

MCP Server 17TRACK

基于 17TRACK API 的模型上下文协议服务器，用于包裹物流跟踪。

安装

npx -y mcp-server-17track@latest

快速开始

1. 注册 17TRACK 开发者账号

介绍

17TRACK API 是一个物流查询接口，通过 API 可以查询 17TRACK 所支持的 2,927 运输商的物流信息。API 基于 HTTP 协议与开发语言无关，通过 WEBHOOK 机制实现信息传递（先注册单号再推送信息），全程自动跟踪物流信息。

查看支持的运输商：https://www.17track.net/zh-cn/carriers

请确保您已成功注册了 API 账号，如果还没有请访问：https://api.17track.net

每月可以使用 100 个免费单号。

获取密钥

使用 API 账号登录后访问设置页获取密钥。

更改密钥

在设置页点击"更改密钥"按钮，新密钥生效时间会有最长 5 分钟延迟，新密钥生效后旧密钥立即失效。

注意事项

• 不建议在网页端使用���有泄露密钥的风险
• 每个接口请求限制频率为 3req/s，超限会报 429 错误
• 所有接口响应报文中的时间都是 UTC 格式
• 所有接口在保持兼容的基础上可能会扩展内容
• 所有接口响应数据，当各属性没有信息时统一显示为 null
• 物流单号与运输商代码组合成数据的唯一标识
• 为保障数据传输安全，请将所有涉及数据传输的服务统一升级到 TLSv1.2 或更高版本

2. 配置 MCP 服务器

2.1 Claude Desktop 配置示例

在 Claude Desktop 配置文件中添加以下配置：

{
  "mcpServers": {
    "mcp-server-17track": {
      "command": "npx",
      "args": ["-y", "mcp-server-17track@latest"],
      "env": {
        "API_TOKEN_17TRACK": "your_17track_api_token"
      }
    }
  }
}

将 your_17track_api_token 替换为您从设置页获取的实际 17TRACK API 令牌。

功能特性

• 支持 2,927+ 运输商的包裹跟踪
• 实时物流信息查询
• 自动运输商识别
• 详细的配送状态更新

使用方法

配置完成后，您可以通过提供快递单号来使用 MCP 服务器跟踪包裹。服务器将自动查询 17TRACK API 并返回详细的物流跟踪信息。

环境要求

• Node.js >= 18

许可证

Apache License 2.0

作者

admin@17track.net

关键词

• mcp
• model-context-protocol
• 17track
• package-tracking
• logistics
• shipping
• 物流跟踪
• 快递查询