MCP Ev Assistant Server

🚀 MCP 電気自動車アシスタントサーバー

このサーバーは、電気自動車（EV）の充電スタンド管理、行程計画、リソース管理などの機能を提供する強力なサーバー実装です。電気自動車関連のサービスに必要な包括的なツールと API を提供します。

🚀 クイックスタート

このサーバーを使用することで、電気自動車の充電スタンド管理や行程計画、リソース管理を効率的に行うことができます。以下のセクションで、具体的な機能や使い方を説明します。

✨ 主な機能

1. 電気自動車充電スタンドサービス

• 充電スタンドの位置特定: 位置と好みに基づいて、近くの電気自動車充電スタンドを検索します。
• コンセントタイプの絞り込み: 特定の充電コンセントタイプ（CCS、CHAdeMO、Type 2 など）を検索します。
• 距離に基づく検索: 検索半径を指定して充電スタンドを探します。

2. 行程計画

• ルート計画: 電気自動車に適した走行ルートを計画します。
• 充電スタンドの停留地点の統合: 必要な充電停留地点を自動的に含めます。
• 航続距離の考慮: 車両の航続距離と現在の電池残量を考慮します。

3. リソース管理

• PDF ドキュメント管理: /Data ディレクトリ内の PDF ファイルを処理します。
• リソース購読システム: リソースの購読と購読解除をサポートします。

4. エラー処理

• 包括的なエラーログ記録: 詳細なエラー情報を記録します。
• 多段階フォールバックメカニズム: PDF 処理で複数の代替方法を提供します。
• 入力検証: Pydantic モデルを使用してデータを検証します。
• スマートなリソース欠損処理

📦 インストール

リポジトリのクローン

git clone https://github.com/yourusername/ev-assistant.git
cd ev-assistant

依存関係のインストール

pip install -r requirements.txt

サーバーの起動

python main.py

📚 ドキュメント

設定

環境変数

サーバーの動作を設定するには、以下の環境変数を設定します。

• EV_ASSISTANT_API_KEY: API アクセスキー
• EV_ASSISTANT_DATA_PATH: PDF リソースディレクトリのパス

設定ファイルの例

# config.py
API_KEY = "your_api_key_here"
DATA_DIRECTORY = "/path/to/data/files"

使用方法

新しいツールの追加

1. core.schemas でツールモデルを定義します。
2. agentTools でツール機能を実装します。
3. handle_list_tools() にツールを追加します。
4. handle_call_tool() でツールの処理ロジックを実装します。

コード例

# tools_example.py
def new_tool_function():
    # 処理ロジック
    pass

# 在 handle_list_tools 中注册工具
TOOLS.append(new_tool_function)

API リファレンス

充電スタンド検索 API

async def search_charging_stations(location: str, radius: int = 50):
    """
    根据位置和半径查找附近的充电站。
    
    参数:
        location (str): 搜索位置
        radius (int, 可选): 搜索半径，单位为公里，默认为 50 公里
        
    返回:
        list: 包含充电站详细信息的列表
    """
    pass

リソース購読 API

async def subscribe_resource(resource_uri: str):
    """
    订阅指定的资源。
    
    参数:
        resource_uri (str): 要订阅的资源 URI
        
    返回:
        bool: 表示订阅是否成功的布尔值
    """
    pass

async def unsubscribe_resource(resource_uri: str):
    """
    取消订阅指定的资源。
    
    参数:
        resource_uri (str): 要取消订阅的资源 URI
        
    返回:
        bool: 表示取消订阅是否成功的布尔值
    """
    pass

リソース管理

PDF リソースの処理

• /Data ディレクトリ内の PDF ファイルを自動的に検出します。
• 複数のテキスト抽出方法をサポートします。
• リソースの更新とバージョン管理を処理します。

購読操作の例

# 订阅资源
await client.subscribe_resource("file:///pdf/ev_manual")

# 取消订阅
await client.unsubscribe_resource("file:///pdf/ev_manual")

エラー処理

一般的なエラーコード

• 401 Unauthorized: 未授权访问
• 503 Service Unavailable: サービス利用不可
• 429 Too Many Requests: リクエスト過多

ログの例

INFO: Server started on port 8000
DEBUG: Successfully parsed configuration file
ERROR: Failed to connect to database: connection refused

開発

新しい機能モジュールの作成

1. core ディレクトリに新しい Python ファイルを作成します。
2. 必要な機能ロジックを実装します。
3. __init__.py を更新して新しいモジュールを含めます。
4. 新しい機能をテストし、見つかったエラーを修正します。

テストコードの例

def test_new_feature():
    assert new_function() == expected_output

貢献ガイド

1. ** リポジトリをフォークする**
2. ** 機能ブランチを作成する** (git checkout -b feature/AmazingFeature)
3. ** 変更をコミットする** (git commit -m '添加某个 Amazing 功能')
4. ** ブランチにプッシュする** (git push origin feature/AmazingFeature)
5. ** Pull Request を提出する**

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。