uupt-mcp-server

🚀 UU跑腿 MCP 服务器

UU跑腿 MCP 服务器是一个轻量级的 MCP Server，可通过 MCP 协议在 uupt.com 开放平台创建订单，为智能体应用开发提供便捷的配送服务接入能力。 https://open.uupt.com/

🚀 快速开始

配置 Python 本地环境

建议使用 Python 3.11 版本。

安装命令

pip3 install -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server

更新命令

pip3 install -U -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server

查看安装是否成功

pip3 list

配置mcpService

{
  "mcpServers": {
    "uupt-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "command": "python",
      "args": [
        "-m",
        "uupt-mcp-server"
      ],
      "env": {
        "APP_ID": "您的APP_ID",
        "APP_SECRET": "您的APP_SECRET",
        "API_KEY": "您的API_KEY",
        "ENDPOINT": "https://api.uupt.com"
      },
      "logging": {
        "level": "INFO",
        "file": "mcp_server.log"
      }
    }
  }
}

示例

启动 MCP Server：

python -m uupt.mcp_server start

✨ 主要特性

UU跑腿的核心 API 现已全面兼容 MCP 协议，是国内首家支持 MCP 协议的配送服务商。UU 跑腿已经完成核心 API 接口和 MCP 协议的对接，涵盖询价、发单、订单详情、配送员实时位置等功能。作为国内首家支持 MCP 协议的配送服务商，UU 跑腿 MCP Server 发布后，智能体开发者仅需简单配置，就可以在大模型中快速接入配送服务，实现一句话发单的能力，大幅降低了智能体应用开发过程中调用配送服务相关能力的门槛，显著提升了智能体应用的开发效率。

💻 使用示例

地址询价

获取订单价格。

输入参数

• fromAddress：发货地址
• toAddress：收货人地址
• adCode：订单区域编码
• sendType：订单类型

输出参数

• priceToken：金额令牌（提交订单使用）
• needPayMoney：实际支付金额

地址发单

输入参数

• priceToken：金额令牌（计算订单价格接口返回的price_token）
• receiverPhone：收件人电话（手机号码）

输出参数

• orderCode：UU 订单号

取消订单

输入参数

• orderCode：UU 订单号
• reason：取消原因

输出参数

• deductFee：扣除费用（单位：分）

查询订单

输入参数

• orderCode：UU 订单号

输出参数

• fromAddress：发货地址
• toAddress：收货人地址
• distance：配送距离
• state：当前状态

📚 详细文档

创建应用和秘钥

注册开放平台

1. 注册 UU 跑腿开放平台账号。
2. 注册成功后登录，进入“我的首页”。

添加应用

1. 点击左侧菜单栏“我的应用”。
2. 创建应用并获得秘钥。

查看应用秘钥

1. 系统已集成 UU 跑腿配送，应用秘钥配置至发单系统即可使用。
2. 未集成开发者进行接口对接。

图片示例

图 1: 配置界面示例

图 2: 安装成功提示