https://github.com/kuaidi100-api/kuaidi100-MCP
快递100推出了国内首个兼容MCP协议的物流信息服务平台—快递100 MCP Server。 快递100旗下百递云·API开放平台的核心API服务现已全面支持MCP协议。开发者简单配置即可快速接入快递查询、运费预估、智能时效预估（含全程与在途模式）等核心功能。
https://github.com/kuaidi100-api/kuaidi100-MCP
Last synced: about 2 months ago
JSON representation
快递100推出了国内首个兼容MCP协议的物流信息服务平台—快递100 MCP Server。 快递100旗下百递云·API开放平台的核心API服务现已全面支持MCP协议。开发者简单配置即可快速接入快递查询、运费预估、智能时效预估（含全程与在途模式）等核心功能。
- Host: GitHub
- URL: https://github.com/kuaidi100-api/kuaidi100-MCP
- Owner: kuaidi100-api
- License: apache-2.0
- Created: 2025-06-09T09:20:57.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2025-08-29T06:56:50.000Z (2 months ago)
- Last Synced: 2025-08-29T10:42:48.162Z (2 months ago)
- Language: Python
- Size: 127 KB
- Stars: 5
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **kuaidi100-MCP** - 快递100推出了国内首个兼容MCP协议的物流信息服务平台—快递100 MCP Server。 快递100旗下百递云·API开放平台的核心API服务现已全面支持MCP协议。开发者简单配置即可快速接入快递查询、运费预估、智能时效预估（含全程与在途模式）等核心功能。 `python` `mcp` `server` `api` `pip install git+https://github.com/kuaidi100-api/kuaidi100-MCP` (AI/ML)
- awesome-mcp-servers - **kuaidi100-MCP** - 快递100推出了国内首个兼容MCP协议的物流信息服务平台—快递100 MCP Server。 快递100旗下百递云·API开放平台的核心API服务现已全面支持MCP协议。开发者简单配置即可快速接入快递查询、运费预估、智能时效预估（含全程与在途模式）等核心功能。 `python` `mcp` `server` `api` `pip install git+https://github.com/kuaidi100-api/kuaidi100-MCP` (🤖 AI/ML)
README
## 快递100 MCP Server (Python)
通过`uv`安装`python`，最低版本要求为3.11
```bash
uv python install 3.11
```
### 获取快递100 API KEY
登录快递100获取： [快递100官方](https://api.kuaidi100.com/extend/register?code=d1660fe0390d4084b4f27b19d2feee02) （注意不要泄露授权key，以防被他人盗用！！！）
### 一、STDIO方式：在线获取快递100 MCP服务运行
通过`uvx`命令一步获取kuaidi100_mcp并使用
```json
{
"mcpServers": {
"kuaidi100": {
"command": "uvx",
"args": [
"kuaidi100-mcp"
],
"env": {
"KUAIDI100_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
### 二、STDIO方式：下载本项目至本地，配置本地项目后运行
通过`uv`创建一个项目
```bash
uv init kuaidi100_mcp
```
将`api_mcp.py`拷贝到该目录下，通过如下命令测试mcp server是否正常运行
```bash
uv run --with mcp[cli] mcp run {YOUR_PATH}/kuaidi100_mcp/api_mcp.py
# 如果是mac，需要加转义符
uv run --with mcp\[cli\] mcp run {YOUR_PATH}/kuaidi100_mcp/api_mcp.py
```
如果没有报错则MCP Server启动成功
#### 在支持MCP的客户端中使用
在MCP Server配置文件中添加如下内容后保存
```json
{
"mcpServers": {
"kuaidi100": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"{YOUR_PATH}/kuaidi100_mcp/api_mcp.py"
],
"env": {
"KUAIDI100_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
### 三、SSE方式：
配置SSE链接和KEY后使用
```json
"kuaidi100": {
"url": "https://api.kuaidi100.com/mcp/sse?key=YOUR_API_KEY"
}
```
### 测试
#### 物流轨迹查询：
#### 快递预估时效：
#### 快递预估价格
### Tips
如需获取账号信息（如 key、customer、secret），或免费试用100单，请访问[API开放平台](https://api.kuaidi100.com/home?code=d1660fe0390d4084b4f27b19d2feee02)进行注册