kuaidi100-mcp 0.1.1

快递100推出了国内首个兼容MCP协议的物流信息服务平台—快递100 MCP Server。 快递100旗下百递云·API开放平台的核心API服务现已全面支持MCP协议。开发者简单配置即可快速接入快递查询、运费预估、智能时效预估（含全程与在途模式）等核心功能。

快递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后使用（可能存在客户端支持问题）

"kuaidi100": {
    "url": "https://api.kuaidi100.com/mcp/sse?key=<YOUR_API_KEY>"
}

测试

物流轨迹查询：

快递预估时效：

快递预估价格

Tips

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