Kuaidi100 Mcp

What is Kuaidi100 Mcp

kuaidi100-MCP is the first logistics information service platform in China compatible with the MCP protocol, launched by Kuaidi100. It is a core API service of the Baidi Cloud API open platform, providing developers with easy access to essential features such as package tracking, freight estimation, and intelligent time estimation.

Use cases

Use cases for kuaidi100-MCP include integrating logistics tracking into e-commerce platforms, providing freight cost estimates for shipping companies, and offering time estimation services for logistics providers.

How to use

To use kuaidi100-MCP, install Python version 3.11 using ‘uv’, create a project with ‘uv init mcp_server_kuaidi100’, and copy ‘api_mcp.py’ to the project directory. Run the MCP server with ‘uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_kuaidi100/api_mcp.py’. Obtain your Kuaidi100 API key from the Kuaidi100 website and configure the MCP server settings in your client.

Key features

Key features of kuaidi100-MCP include compatibility with the MCP protocol, support for package tracking, freight estimation, and intelligent time estimation (including full journey and in-transit modes). It also provides a straightforward setup process for developers.

Where to use

kuaidi100-MCP can be used in various fields such as e-commerce, logistics, and supply chain management, where real-time tracking and estimation of delivery times and costs are essential.

快递100 MCP Server (Python)

通过uv安装python，最低版本要求为3.11

uv python install 3.11

获取快递100 API KEY

登录快递100获取 https://poll.kuaidi100.com/manager/page/myinfo/enterprise （注意不要泄露授权key，以防被他人盗用！！！）

一、STDIO方式：在线获取快递100 MCP服务运行（推荐）

通过uvx命令一步获取kuaidi100_mcp并使用

{
  "mcpServers": {
    "kuaidi100": {
      "command": "uvx",
      "args": [
        "kuaidi100-mcp"
      ],
      "env": {
        "KUAIDI100_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

二、STDIO方式：下载本项目至本地，配置本地项目后运行

通过uv创建一个项目

uv init mcp_server_kuaidi100

将api_mcp.py拷贝到该目录下，通过如下命令测试mcp server是否正常运行

uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_kuaidi100/api_mcp.py
# 如果是mac，需要加转义符
uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_kuaidi100/api_mcp.py

如果没有报错则MCP Server启动成功

在支持MCP的客户端中使用

在MCP Server配置文件中添加如下内容后保存

{
  "mcpServers": {
    "kuaidi100": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{YOUR_PATH}/mcp_server_kuaidi100/api_mcp.py"
      ],
      "env": {
        "KUAIDI100_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

三、SSE方式：

配置SSE链接和KEY后使用（可能存在客户端支持问题）

测试

物流轨迹查询：

快递预估时效：

快递预估价格

Tips

如需获取账号信息（如 key、customer、secret），或免费试用100单，请访问API开放平台进行注册