UU跑腿 MCP Server

UU跑腿 MCP Server

site icon
2025.04.18 0
Python配送服务MCP协议位置服务
UU跑腿MCP Server是一个轻量级的MCP协议服务,用于在UU跑腿开放平台上创建和管理配送订单。它支持询价、发单、取消订单和查询订单等功能,是国内首家兼容MCP协议的配送服务商。通过简单的配置,开发者可以快速在大模型中接入配送服务,显著提升智能体应用的开发效率。
View on GitHub

Overview

基本能力

产品定位

UU跑腿MCP Server是一个轻量级的MCP协议服务,用于在UU跑腿开放平台上创建和管理配送订单。

核心功能

  1. 地址询价:获取订单价格。
  2. 输入参数:fromAddress(发货地址)、toAddress(收货人地址)、adCode(订单区域编码)、sendType(订单类型)。
  3. 输出参数:priceToken(金额令牌)、needPayMoney(实际支付金额)。
  4. 地址发单:提交订单。
  5. 输入参数:priceToken(金额令牌)、receiverPhone(收件人电话)。
  6. 输出参数:orderCode(UU订单号)。
  7. 取消订单:取消已提交的订单。
  8. 输入参数:orderCode(UU订单号)、reason(取消原因)。
  9. 输出参数:deductFee(扣除费用)。
  10. 查询订单:查询订单详情。
  11. 输入参数:orderCode(UU订单号)。
  12. 输出参数:fromAddress(发货地址)、toAddress(收货人地址)、distance(配送距离)、state(当前状态)。

适用场景

  1. 智能体应用开发中需要快速接入配送服务。
  2. 需要在大模型中实现一句话发单的能力。
  3. 需要降低调用配送服务相关能力的开发门槛。

工具列表

  1. UU跑腿开放平台:用于注册账号、创建应用和获取秘钥。
  2. uupt-mcp-server Python包:用于安装和运行MCP Server。

常见问题解答

  1. 如何注册开放平台账号?
  2. 访问UU跑腿开放平台(https://open.uupt.com/)进行注册。
  3. 如何获取应用秘钥?
  4. 登录开放平台后,进入“我的应用”创建应用并获取秘钥。
  5. 如何安装uupt-mcp-server?
  6. 使用命令pip3 install -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server进行安装。

使用教程

使用依赖

  1. Python环境:建议使用Python 3.11版本。

安装教程

  1. 安装命令bash pip3 install -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server
  2. 更新命令bash pip3 install -U -i https://mirrors.aliyun.com/pypi/simple/ uupt-mcp-server
  3. 查看安装是否成功bash pip3 list

调试方式

  1. 配置mcpServicejson { "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" } } }
  2. 运行示例
  3. 参考示例图(https://open.uupt.com/img/mcp-demo-1.584e5cae.png)和(https://open.uupt.com/img/mcp-demo-2.70f7dcf2.png)。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。