e代驾 MCP 服务
基于e代驾开放API的MCP (Model Context Protocol) 服务，提供代驾服务的完整功能。
功能特性
- 预估费用: 根据起终点位置预估代驾费用
- 叫代驾下单: 创建代驾订单，支持自动token管理
- Token管理: 智能token获取、存储和刷新机制
- 自动重试: token过期时自动刷新并重试操作
- 参数验证: 完善的输入参数验证和错误处理
环境配置
1. 创建环境变量文件
复制 .env.example 文件为 .env：
cp .env.example .env2. 配置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并重新执行操作
使用流程
- 预估费用: 使用
estimate_cost提供起终点信息和手机号，获取预估价格 - 确认下单: 使用
call_driver提供相同信息进行下单 - 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 # 项目配置