支持情况
1. 支持使用的 快递鸟接口: 单号识别、在途监控(即时查询接口)、地址解析、预计到达时间 ,快递查询,跨境轨迹查询,快递网点查询
准备
1. 注册快递鸟API开放平台
为了使用快递鸟服务,您需要先注册一个快递鸟账户,如果已经注册过,可以直接跳转到第二步
快递鸟API开放平台网址:快递鸟登录中心
![图形用户界面
描述已自动生成]()
2. 获取EBUSINESS_ID 和 API_KEY
注册快递鸟账户后,进入快递鸟API开放平台。在首页,我们可以看到EBUSINESS_ID 和 API_KEY。
![图形用户界面, 应用程序, 网站
描述已自动生成]()
3. 开通对接 API 服务
点击产品管理,选择快递鸟API
![图形用户界面, 网站
描述已自动生成]()
我们在免费使用这里,领取快递查询的API试用
![图形用户界面, 应用程序
描述已自动生成]()
【注】
如果没有开通对应API服务,MCP 是没有这些服务功能的
配置 MCP 服务
您需要通过MCP客户端才可以使用MCP服务,快递鸟支持所有可以使用MCP-SSE模式的MCP客户端。您需要按以下格式进行配置。
需要根据您在快递鸟API开放平台中获取的EBUSINESS_ID和API_KEY。
1 环境搭建
安装 python,最低版本要求为3.11,这里以3.11.9为例
python3.11.9下载地址:Python Release Python 3.11.9 | Python.org
![图形用户界面, 表格
描述已自动生成]()
直接下一步,下一步,把能勾选的勾选上就行了,安装完成后,我们输入下放命令校验一下
python --version
![文本
描述已自动生成]()
使用下方命令下载安装uv
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
查看一下是否安装完成
![文本
描述已自动生成]()
安装完成uv之后,默认已经配置了uvx 命令
【注】
安装之后,如果uv命令无效,可能是没有配置环境变量,需要你在powershell和cmd中分别执行下方的命令,配置对应环境变量
![文本
描述已自动生成]()
接下来安装一下,MCP本地服务(有这个MCP服务,第三方MCP客户端的配置才会生效)
pip install kdnmcp
使用下方命令,查看kdnmcp是否安装
kdnmcp --help
如下图,即安装成功
![文本
描述已自动生成]()
1 STDIO(推荐)
{
"mcpServers": {
"kdnmcp": {
"command": "uvx",
"args": [
"kdnmcp"
],
"env": {
"EBUSINESS_ID": "<YOUR_EBUSINESS_ID>",
"API_KEY": "<YOUR_API_KEY>",
"PYTHONIOENCODING": "utf-8"
}
}
}
}
1 Streamable HTTP(Web)
https://kdnmcp.kdniao.com/mcp?EBUSINESS_ID=<YOUR_EBUSINESS_ID>&API_KEY=<YOUR_API_KEY>
使用第三方MCP客户端配置教程
1 在 Cherry Studio 中使用 快递鸟 MCP Server
1.1 下载安装 Cherry Studio
Cherry Studio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台
Cherry Studio下载地址:Cherry Studio 官方网站 - 全能的 AI 助手
1.2 添加快递鸟 MCP 服务器
进入CherryStudio,进入设置,选择MCP,以JSON形式导入MCP服务配置(第四节中的STDIO方式)
将EBUSINESS_ID和API_KEY替换为你自己的
文档地址:https://www.yuque.com/kdnjishuzhichi/dfcrg1/ct98h538lbx6i68k
