Eventor MCP Server

🚀 Eventor API クライアント

EventorのオリエンテーションAPIと統合するためのPythonクライアントです。イベント、参加者、結果データへのアクセスを提供します。

✨ 主な機能

• イベント結果、参加者、組織情報へのアクセス
• API呼び出し回数を減らすためのキャッシュシステムを構成可能
• AIアシスタント用のMCP（モデルコンテキストプロトコル）サーバーとの統合
• MCPサーバーで使用する3つのツールを提供：
  • get_weekly_club_results()：週次のクラブ試合結果を取得し、LLMにまとめてレポートを生成させることができます。
  • get_personal_events()：指定されたpersonId（設定ファイル内）と時間範囲に基づいて、個人のイベント情報を取得します。
  • get_detailed_result_for_event_and_person()：特定のイベントとpersonId（設定ファイル内）に基づいて、詳細な試合結果を取得します。
• いくつかの解析を行い、LLMに適した形式でデータを提供しようとします。
• デバッグモード：クライアントを独立して実行し、JSON出力を生成して確認できます。
• 安全なアクセスを確保するため、APIキーとpersonIdを構成可能

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/grapatin/eventor-mcp-server.git
cd eventor-mcp-server

2. 仮想環境を作成します：

uv venv .venv
source .venv/bin/activate  # Windowsシステムの場合は：.venv\Scripts\activate を使用してください

3. 依存関係をインストールします：

uv pip install -r requirements.txt

4. APIキーを設定します：

cp eventor_config_example.py eventor_config.py
# 実際の情報に基づいて、eventor_config.pyファイル内のAPIキー、personId、その他の設定を編集してください

💻 使用例

基本的な使用法

デバッグするには、デバッグモードで実行します。__main__関数が含まれており、独立した環境で実行して結果のJSONファイルを生成し、確認することができます。

python -m eventor

高度な使用法

ClaudeにMCPサーバーをインストールするには、cluade_desktopr_config.jsonに以下の内容を追加します。

    "Eventor Results API": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/eventor-mcp-server",
        "run",
        "mcp",
        "run",
        "mcp_server.py"
      ]
    }

📚 ドキュメント

設定はeventor_config.pyファイルを通じて行われます。このファイルには機密情報が含まれているため、バージョン管理による漏洩を避けるために.gitignoreに追加する必要があります。 このファイルに、Eventor APIキー（Eventor管理者に問い合わせて取得してください）と自分のpersonId（出力されたJSONファイルから探すことができます）を追加してください。