# 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版本。

### 安装命令

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

### 更新命令

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

### 查看安装是否成功

```bash
pip3 list
```

### 配置`mcpService`

```json
{
  "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"
    }
  }
}
```

### 示例

![示例图](https://open.uupt.com/img/mcp-demo-1.584e5cae.png)
![示例图](https://open.uupt.com/img/mcp-demo-2.70f7dcf2.png)