e代驾 MCP Server

e代驾 MCP 服务

基于e代驾开放API的MCP (Model Context Protocol) 服务，提供代驾服务的完整功能。

功能特性

• 预估费用: 根据起终点位置预估代驾费用
• 叫代驾下单: 创建代驾订单，支持自动token管理
• Token管理: 智能token获取、存储和刷新机制
• 自动重试: token过期时自动刷新并重试操作
• 参数验证: 完善的输入参数验证和错误处理

环境配置

1. 创建环境变量文件

复制 .env.example 文件为 .env：

2. 配置API密钥

在 .env 文件中设置您的API密钥：

注意: .env 文件包含敏感信息，已被添加到 .gitignore 中，不会被提交到版本控制系统。

可用工具

1. estimate_cost

预估代驾费用

• 参数:
  • start_address: 起始地址
  • start_longitude: 起始经度
  • start_latitude: 起始纬度
  • end_address: 目的地地址
  • end_longitude: 目的地经度
  • end_latitude: 目的地纬度
  • phone: 用户手机号（11位数字）
• 返回: 预估费用信息，包括距离、时间和价格
• 特性: 自动检查和刷新token，支持token过期重试

2. call_driver

叫代驾下单

• 参数:
  • start_address: 起始地址
  • start_longitude: 起始经度
  • start_latitude: 起始纬度
  • end_address: 目的地地址
  • end_longitude: 目的地经度
  • end_latitude: 目的地纬度
  • phone: 用户手机号（11位数字）
  • contact_phone: 联系电话（可选，代叫订单必传）
• 返回: 下单结果，包括订单号和状态
• 特性: 自动生成唯一订单号，支持token校验失败重试

3. refresh_token

刷新用户token

• 参数:
  • phone: 用户手机号（11位数字）
• 返回: token刷新结果和状态
• 特性: 手动刷新指定手机号的认证token

Token管理机制

• 自动检测: 系统自动检查本地是否存在对应手机号的token
• 智能获取: 如无本地token，自动调用API获取新token
• 本地存储: token自动保存到 edjserver/tokens/ 目录
• 过期处理: API返回token过期时自动刷新并重试
• 校验重试: token校验失败时自动刷新token并重新执行操作

使用流程

1. 预估费用: 使用 estimate_cost 提供起终点信息和手机号，获取预估价格
2. 确认下单: 使用 call_driver 提供相同信息进行下单
3. Token管理: 如需要，使用 refresh_token 手动刷新token

技术特性

• 智能重试: token相关错误自动处理，无需手动干预
• 参数验证: 完善的输入验证，确保数据格式正确
• 错误处理: 详细的错误信息返回，便于问题定位
• 唯一订单号: 基于时间戳和UUID生成唯一订单标识

运行方式

依赖项

• mcp: Model Context Protocol库
• requests: HTTP请求库
• python-dotenv: 环境变量管理
• uuid: 唯一标识符生成
• time: 时间戳生成
• json: JSON数据处理
• os: 文件系统操作

项目结构