快递鸟 MCP 模式对接文档

支持情况

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

使用下方命令下载安装 uvpowershell -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 Server1.1 下载安装 Cherry StudioCherry Studio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台 Cherry Studio 下载地址：Cherry Studio 官方网站 - 全能的 AI 助手 1.2 添加快递鸟 MCP 服务器进入 CherryStudio，进入设置，选择 MCP，以 JSON 形式导入 MCP 服务配置（第四节中的 STDIO 方式）将 EBUSINESS_ID 和 API_KEY 替换为你自己的

1.3 使用案例先启用快递鸟 MCP 服务

我们让 CheeryStudio 使用 快递鸟 MCP 帮我们查一个快递的物流信息

可以看到，已经获取到了物流信息了 2 在 Trae 中使用快递鸟 MCP Server2.1 下载安装 TRAE 登录 TRAE CN，下载安装包安装。2.2 配置 MCP 服务器打开 Trae，登录。Ctrl+U 打开 AI 对话页



1. 点击右上角齿轮设置页面，选择 mcp

2. 点击添加按键

3. 选择手动配置

4. 将下面配置导入，需要把第二步获取到的 EBUSINESS_ID 和 API_KEY 填入对应位置{"mcpServers": {"kdnmcp": {"command": "uvx","args": ["kdnmcp"],"env": {"EBUSINESS_ID": "<YOUR_EBUSINESS_ID>","API_KEY": "<YOUR_API_KEY>","PYTHONIOENCODING": "utf-8"}}}}打勾就是配置生效了

2.3 使用案例返回对话，选择 BuilderwithMCP

我们让 TRAE 使用快递鸟 MCP 帮我们查一个快递的物流信息

可以看到，已经获取到了物流信息了 3 在 Dify 中使用快递鸟 MCP Server3.1 注册 Dify 账户 Dify 网址：https://cloud.dify.ai/首先，我们需要进来 Dify 网站，并且注册一个账户登录（这里就赘述，如果进不去网站，可以使用科学上网的方式进去）3.2 创建 MCP 服务这个案例主要以 http 的方式创建 MCP 服务

首先，我们在工具这里选择 MCP，点击添加 MCP 服务

主要配置就是这个服务端点 URL，具体格式如下https://kdnmcp.kdniao.com/mcp?EBUSINESS_ID=YOUR_EBUSINESS_ID&API_KEY=YOUR_API_KEY其中，EBUSINESS_ID 与 API_KEY 需要替换成你自己的，点击添加并授权，如果显示下面的截图，就是配置成功了

3.3 使用案例接下来，我们在聊天助手中使用这个 MCP 服务，先创建一个聊天助手

添加 MCP 服务

添加完成之后，我们还需要在选择一下，AI 模型，选择 gpt-4o 就可以了

最后让 AI 使用 快递鸟 MCP 帮我们查一下快递信息，可以看到 AI 已经通过快递鸟的 MCP 获取到快递单号物流状态了

可以看到，已经获取到了物流信息了 4 在 Cursor 中使用 快递鸟 MCP Server4.1 Cursor 下载安装 Cursor 下载地址：Cursor：用 AI 编码的最佳方式【注】可能需要科学上网才能访问 4.2 添加 MCP 服务打开智能聊天助手，选择更多，点击 ChatSettings

添加 MCP

把在第四节中 STDIO 方式粘贴进来即可，其中 EBUSINESS_ID 和 API_KEY 改为你自己申请的即可

再次进入 ChatSettings 就可以看到，我们的快递鸟 MCP 已经跑起来了

【注】如果报错，可能是 Cursor 刚安装是没有勾选环境变量，需要重新卸载安装 Cursor，或者手动配置一下环境变量。4.3 使用案例我们在聊天助手，让他帮我们查询一下快递的物流信息

可以看到，已经获取到了物流信息了文档地址：https://www.yuque.com/kdnjishuzhichi/dfcrg1/ct98h538lbx6i68k