edaijiamcp-project

fengfengsu/edaijiamcp-project

3.2

If you are the rightful owner of edaijiamcp-project and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The e代驾 MCP Service provides a comprehensive suite of features for designated driving services through its open API.

Tools

  1. call_driver

    Allows users to request a designated driver service by providing their phone number and departure location.

  2. calculate_distance_and_price

    Calculates the distance and estimated price between two locations.

  3. create_order

    Creates a designated driving order with optional destination information.

  4. check_order_status

    Checks the real-time status of an order.

  5. cancel_order

    Cancels an existing order with an optional reason.

e代驾 MCP 服务

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

功能特性

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

环境配置

1. 创建环境变量文件

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

cp .env.example .env

2. 配置API密钥

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

APP_KEY=your_app_key_here
SECRET=your_secret_here
API_BASE_URL=https://openapi.d.edaijia.cn

注意: .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生成唯一订单标识

运行方式

python edaijiamcp.py

依赖项

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

项目结构

edaijiamcp/
├── edaijiamcp.py          # MCP服务主文件
├── edjserver/             # e代驾API封装
│   ├── EdjApi.py         # 主要API接口
│   ├── EdjSignUtils.py   # 签名工具
│   ├── EdjSystemParams.py # 系统参数
│   └── tokens/           # token存储目录
├── README.md             # 项目文档
└── pyproject.toml        # 项目配置