## 快递100 MCP Server

### 获取快递100 API KEY
登录快递100获取： [快递100官方](https://api.kuaidi100.com/extend/register?code=d1660fe0390d4084b4f27b19d2feee02) （注意不要泄露授权key，以防被他人盗用！！！）

### 一、STDIO方式：在线获取快递100 MCP服务运行
#### Python方式：通过`uvx`命令一步获取kuaidi100_mcp并使用
```json
{
  "mcpServers": {
    "kuaidi100": {
      "command": "uvx",
      "args": [
        "kuaidi100-mcp"
      ],
      "env": {
        "KUAIDI100_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```
如果没有报错则MCP Server启动成功

#### NodeJs方式：通过npx命令一步获取kuaidi100_mcp并使用
```json
{
  "mcpServers": {
    "kuaidi100": {
      "command": "npx",
      "args": [
        "-y",
        "@kuaidi100-mcp/kuaidi100-mcp-server"
      ],
      "env": {
        "KUAIDI100_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```
关联项目：[kuaidi100-MCP-Nodejs](https://github.com/kuaidi100-api/kuaidi100-MCP-Nodejs)

### 二、Streamable方式：
配置Http链接和KEY后使用
```json
"kuaidi100": {
    "url": "https://api.kuaidi100.com/mcp/streamable?key=YOUR_API_KEY"
}
```

### 三、SSE方式（更推荐Streamable连接方式）：
配置SSE链接和KEY后使用
```json
"kuaidi100": {
    "url": "https://api.kuaidi100.com/mcp/sse?key=YOUR_API_KEY"
}
```

### 测试

#### 物流轨迹查询：
![trae_test_queryTrace.png](https://file.kuaidi100.com/downloadfile/DTjS9PHPonJXikObm8OTcEA3OnuWBw0livDDJc73jYGMQmcwqfJpKhTzSVA-UwVX9LJZE3Nnnw7iLRgmekijRw)
#### 快递预估时效：
![trae_test_estimateTime.png](https://file.kuaidi100.com/downloadfile/NL6vRCRVQkmvdavX19DISKf8uCvrj3q5NkSNl0ALv8GOOUufxrYRTRxoZJ20_uF-MGURmZRcKxS5XfAaz9t39Q)
#### 快递预估价格
![trae_test_estimatePrice.png](https://file.kuaidi100.com/downloadfile/mPv7xFAUbsY5yFbaQZn7Z0ihtIU781pksXTTj-L2wwVgZ3dH-OSvqEdm3IaJzimTF_xIWbtHD6OFP8w2i35xsQ)

### Tips
如需获取账号信息（如 key、customer、secret），或免费试用100单，请访问[API开放平台](https://api.kuaidi100.com/home?code=d1660fe0390d4084b4f27b19d2feee02)进行注册