Edaijiamcp Project

🚀 e代驾MCPサービス

e代驾のオープンAPIに基づくMCP (Model Context Protocol) サービスで、代行運転サービスの全機能を提供します。

✨ 主な機能

• 料金見積もり：出発地と目的地の位置に基づいて、代行運転の料金を見積もります。
• 代行運転の注文作成：代行運転の注文を作成し、自動的なトークン管理をサポートします。
• トークン管理：トークンの取得、保存、更新を自動的に行う仕組みがあります。
• 自動再試行：トークンが期限切れになった場合、自動的に更新して操作を再試行します。
• パラメータ検証：入力パラメータの検証とエラー処理が充実しています。

📦 インストール

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桁の数字）
• 戻り値：見積もり料金情報（距離、時間、価格を含む）
• 特徴：トークンの自動チェックと更新を行い、トークンの期限切れ時の再試行をサポートします。

2. call_driver

代行運転の注文を作成します。

• パラメータ
  • start_address：出発地の住所
  • start_longitude：出発地の経度
  • start_latitude：出発地の緯度
  • end_address：目的地の住所
  • end_longitude：目的地の経度
  • end_latitude：目的地の緯度
  • phone：ユーザーの携帯電話番号（11桁の数字）
  • contact_phone：連絡先電話番号（オプション、代行注文の場合は必須）
• 戻り値：注文結果（注文番号とステータスを含む）
• 特徴：一意の注文番号を自動生成し、トークン検証失敗時の再試行をサポートします。

3. refresh_token

ユーザーのトークンを更新します。

• パラメータ
  • phone：ユーザーの携帯電話番号（11桁の数字）
• 戻り値：トークンの更新結果とステータス
• 特徴：指定された携帯電話番号の認証トークンを手動で更新します。

トークン管理メカニズム

• 自動検出：システムが自動的にローカルに対応する携帯電話番号のトークンが存在するかをチェックします。
• 自動取得：ローカルにトークンが存在しない場合、自動的にAPIを呼び出して新しいトークンを取得します。
• ローカル保存：トークンは自動的に edjserver/tokens/ ディレクトリに保存されます。
• 期限切れ処理：APIがトークンの期限切れを返した場合、自動的に更新して操作を再試行します。
• 検証再試行：トークンの検証に失敗した場合、自動的にトークンを更新して操作を再実行します。

使用フロー

1. 料金見積もり：estimate_cost を使用して出発地と目的地の情報および携帯電話番号を提供し、見積もり価格を取得します。
2. 注文確認：call_driver を使用して同じ情報を提供して注文を行います。
3. トークン管理：必要に応じて、refresh_token を使用してトークンを手動で更新します。

技術的特徴

• 自動再試行：トークン関連のエラーを自動的に処理し、手動での介入は必要ありません。
• パラメータ検証：入力検証が充実しており、データ形式が正しいことを確保します。
• エラー処理：詳細なエラー情報を返し、問題の特定を容易にします。
• 一意の注文番号：タイムスタンプとUUIDに基づいて一意の注文識別子を生成します。

💻 使用例

基本的な使用法

python edaijiamcp.py

依存関係

プロジェクト構造

edaijiamcp/
├── edaijiamcp.py          # MCPサービスのメインファイル
├── edjserver/             # e代驾APIのラッパー
│   ├── EdjApi.py         # 主要なAPIインターフェース
│   ├── EdjSignUtils.py   # 署名ユーティリティ
│   ├── EdjSystemParams.py # システムパラメータ
│   └── tokens/           # トークンの保存ディレクトリ
├── README.md             # プロジェクトドキュメント
└── pyproject.toml        # プロジェクト設定