UUPT FREIRHT MCP

UU货运 MCP Server

一个轻量级的MCP Server，用于通过MCP协议在uupt.com开放平台创建订单 https://open.uupt.com/

产品介绍

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

功能介绍

地址询价

获取订单价格。

输入参数

• fromAddress：发货地址
• toAddress：收货人地址
• transportType：车辆类型

输出参数

• 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. 未集成开发者进行接口对接。

快速开始

配置Python本地环境

建议使用Python 3.11版本。

安装命令

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

更新命令

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

查看安装是否成功

pip3 list

配置mcpService

{
  "mcpServers": {
    "uupt_mcp_freight_server": {
      "disabled": false,
      "timeout": 60,
      "command": "python",
      "args": [
        "-m",
        "uupt_mcp_freight_server"
      ],
      "env": {
        "APP_ID": "您的APP_ID",
        "APP_SECRET": "您的APP_SECRET",
        "OPEN_ID": "您的OPEN_ID",
        "ORDER_CITY": "郑州市"
      },
      "transportType": "stdio"
    }
  }
}

示例