快递鸟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

![文本

描述已自动生成]()

使用下方命令下载安装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

0
0
0
0
评论
未登录
暂无评论