
UU跑腿 MCP Server

2025.04.18
0
Python配送服务MCP协议位置服务
UU跑腿MCP Server是一个轻量级的MCP协议服务,用于在UU跑腿开放平台上创建和管理配送订单。它支持询价、发单、取消订单和查询订单等功能,是国内首家兼容MCP协议的配送服务商。通过简单的配置,开发者可以快速在大模型中接入配送服务,显著提升智能体应用的开发效率。
View on GitHub
Overview
基本能力
产品定位
UU跑腿MCP Server是一个轻量级的MCP协议服务,用于在UU跑腿开放平台上创建和管理配送订单。
核心功能
- 地址询价:获取订单价格。
- 输入参数:
fromAddress
(发货地址)、toAddress
(收货人地址)、adCode
(订单区域编码)、sendType
(订单类型)。 - 输出参数:
priceToken
(金额令牌)、needPayMoney
(实际支付金额)。 - 地址发单:提交订单。
- 输入参数:
priceToken
(金额令牌)、receiverPhone
(收件人电话)。 - 输出参数:
orderCode
(UU订单号)。 - 取消订单:取消已提交的订单。
- 输入参数:
orderCode
(UU订单号)、reason
(取消原因)。 - 输出参数:
deductFee
(扣除费用)。 - 查询订单:查询订单详情。
- 输入参数:
orderCode
(UU订单号)。 - 输出参数:
fromAddress
(发货地址)、toAddress
(收货人地址)、distance
(配送距离)、state
(当前状态)。
适用场景
- 智能体应用开发中需要快速接入配送服务。
- 需要在大模型中实现一句话发单的能力。
- 需要降低调用配送服务相关能力的开发门槛。
工具列表
- UU跑腿开放平台:用于注册账号、创建应用和获取秘钥。
- uupt-mcp-server Python包:用于安装和运行MCP Server。
常见问题解答
- 如何注册开放平台账号?
- 访问UU跑腿开放平台(https://open.uupt.com/)进行注册。
- 如何获取应用秘钥?
- 登录开放平台后,进入“我的应用”创建应用并获取秘钥。
- 如何安装uupt-mcp-server?
- 使用命令
pip3 install -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server
进行安装。
使用教程
使用依赖
- 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": "python", "args": [ "-m", "uupt-mcp-server" ], "env": { "APP_ID": "您的APP_ID", "APP_SECRET": "您的APP_SECRET", "OPEN_ID": "您的OPEN_ID", "OPENAPI_URL_BASE": "https://openapi.uupt.com/v2_0/" }, "transportType": "stdio" } } }
- 运行示例:
- 参考示例图(https://open.uupt.com/img/mcp-demo-1.584e5cae.png)和(https://open.uupt.com/img/mcp-demo-2.70f7dcf2.png)。