# 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`：收货人地址
- `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. 未集成开发者进行接口对接。
## 快速开始
### 配置Python本地环境
建议使用Python 3.11版本。
### 安装命令
```bash
pip3 install -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server
```
### 更新命令
```bash
pip3 install -U -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server
```
### 查看安装是否成功
```bash
pip3 list
```
### 配置`mcpService`
```json
{
"mcpServers": {
"uupt-mcp-server": {
"disabled": false,
"timeout": 60,
"command": "uvx",
"args": [
"uupt_mcp_server"
],
"env": {
"APP_ID": "您的APP_ID",
"APP_SECRET": "您的APP_SECRET",
"OPEN_ID": "您的OPEN_ID",
"ORDER_CITY": "郑州市（您的发单城市，格式：郑州市，‘市’字请不要省略，必须要有）"
}
}
}
}
```
### 示例
