内容
# parcel-tracking-mcp
一款[模型上下文协议（MCP）](https://modelcontextprotocol.io)服务器，允许克劳德（Claude）和其他任何MCP兼容的AI通过[17track API](https://www.17track.net/en/api)跟踪全球包裹。
## 功能
| 工具 | 描述 |
|------|-------------|
| `track_parcel` | 注册 + 获取单个包裹的实时跟踪信息 |
| `track_multiple_parcels` | 批量跟踪最多40个包裹 |
| `register_tracking` | 注册跟踪号码而不获取数据 |
| `stop_tracking` | 停止监控包裹（节省配额） |
| `delete_tracking` | 永久从您的帐户中删除包裹 |
| `get_quota` | 检查您的API配额使用情况 |
支持**2,400+**家快递公司，包括联邦快递（FedEx）、UPS、DHL、美国邮政（USPS）、皇家邮政（Royal Mail）、亚马逊物流（Amazon Logistics）等数百家。
## 要求
- Node.js 18+
- 一个[17track API密钥](https://www.17track.net/en/api)（免费层：200个跟踪号码）
## 安装
### 选项1 — npx（无需安装）
```bash
SEVENTEEN_TRACK_API_KEY=您的密钥 npx parcel-tracking-mcp
```
### 选项2 — 全局安装
```bash
npm install -g parcel-tracking-mcp
SEVENTEEN_TRACK_API_KEY=您的密钥 parcel-tracking-mcp
```
### 选项3 — 从源代码构建
```bash
git clone https://github.com/YOUR_USERNAME/parcel-tracking-mcp
cd parcel-tracking-mcp
npm install
npm run build
SEVENTEEN_TRACK_API_KEY=您的密钥 npm start
```
## 克劳德桌面 / 克劳德代码设置
将以下内容添加到您的MCP配置文件中。
**克劳德桌面** (`~/Library/Application Support/Claude/claude_desktop_config.json` 在macOS上)：
```json
{
"mcpServers": {
"parcel-tracking": {
"command": "npx",
"args": ["parcel-tracking-mcp"],
"env": {
"SEVENTEEN_TRACK_API_KEY": "在此处输入您的API密钥"
}
}
}
}
```
**克劳德代码** (`~/.claude/settings.json`）：
```json
{
"mcpServers": {
"parcel-tracking": {
"command": "npx",
"args": ["parcel-tracking-mcp"],
"env": {
"SEVENTEEN_TRACK_API_KEY": "在此处输入您的API密钥"
}
}
}
}
```
## 获取17track API密钥
1. 在[17track.net](https://www.17track.net/en/api)注册
2. 进入您的帐户仪表盘中的**API**
3. 创建一个API密钥并复制它
4. 新帐户获得**200个免费跟踪槽位**
## 使用示例
连接后，您可以问克劳德这样的问题：
> "跟踪我的包裹，跟踪号码为1Z999AA10123456784"
> "这些包裹在哪里？[跟踪号码列表]"
> "检查我的联邦快递货件449044304137821的状态"
> "我还剩多少API配额？"
## 快递公司代码
17track使用数字快递公司代码。通常可以省略快递公司，17track会自动检测。常见代码：
| 快递公司 | 代码 |
|---------|------|
| 联邦快递（FedEx） | 100002 |
| UPS | 100001 |
| DHL快递 | 100003 |
| 美国邮政（USPS） | 100027 |
| DHL电子商务 | 100116 |
| 亚马逊物流 | 100208 |
| 皇家邮政 | 190021 |
在17track文档中查看[完整的快递公司列表](https://www.17track.net/en/support/api-doc#carrier)。
## 开发
```bash
npm install
npm run dev # 使用tsx运行（无构建步骤）
npm run build # 编译到dist/
```
## 许可证
MIT
