Edaijiamcp Project

🚀 e代駕 MCP 服務

e代駕 MCP 服務基於 e 代駕開放 API，遵循 MCP（Model Context Protocol），為用戶提供代駕服務的完整功能，覆蓋從費用預估到訂單創建的全流程。

✨ 主要特性

• 預估費用：依據起終點位置，精準預估代駕費用。
• 叫代駕下單：可創建代駕訂單，且具備自動 token 管理功能。
• Token 管理：擁有智能的 token 獲取、存儲和刷新機制。
• 自動重試：當 token 過期時，系統會自動刷新並重新嘗試操作。
• 參數驗證：具備完善的輸入參數驗證和錯誤處理機制。

📦 安裝指南

創建環境變量文件

複製 .env.example 文件為 .env：

cp .env.example .env

配置 API 密鑰

在 .env 文件中設置您的 API 密鑰：

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

⚠️ 重要提示

.env 文件包含敏感信息，已被添加到 .gitignore 中，不會被提交到版本控制系統。

💻 使用示例

可用工具

estimate_cost

用於預估代駕費用。

• 參數：
  • start_address：起始地址
  • start_longitude：起始經度
  • start_latitude：起始緯度
  • end_address：目的地地址
  • end_longitude：目的地經度
  • end_latitude：目的地緯度
  • phone：用戶手機號（11 位數字）
• 返回：預估費用信息，包含距離、時間和價格。
• 特性：自動檢查和刷新 token，支持 token 過期重試。

call_driver

用於叫代駕下單。

• 參數：
  • start_address：起始地址
  • start_longitude：起始經度
  • start_latitude：起始緯度
  • end_address：目的地地址
  • end_longitude：目的地經度
  • end_latitude：目的地緯度
  • phone：用戶手機號（11 位數字）
  • contact_phone：聯繫電話（可選，代叫訂單必傳）
• 返回：下單結果，包含訂單號和狀態。
• 特性：自動生成唯一訂單號，支持 token 校驗失敗重試。

refresh_token

用於刷新用戶 token。

• 參數：
  • phone：用戶手機號（11 位數字）
• 返回：token 刷新結果和狀態。
• 特性：手動刷新指定手機號的認證 token。

使用流程

1. 預估費用：使用 estimate_cost 提供起終點信息和手機號，獲取預估價格。
2. 確認下單：使用 call_driver 提供相同信息進行下單。
3. Token 管理：如需要，使用 refresh_token 手動刷新 token。

🔧 技術細節

Token 管理機制

• 自動檢測：系統自動檢查本地是否存在對應手機號的 token。
• 智能獲取：若本地無 token，自動調用 API 獲取新 token。
• 本地存儲：token 自動保存到 edjserver/tokens/ 目錄。
• 過期處理：當 API 返回 token 過期時，自動刷新並重試。
• 校驗重試：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        # 項目配置