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
- 物流跟踪
- 快递查询