Eventor API Client

Eventor API クライアント

Eventor オリエンテーリング API と連携するための Python クライアントです。大会、エントリー、結果にアクセスできます。

機能

• 大会結果、エントリー、組織データへのアクセス
• API 呼び出しを減らすための設定可能なキャッシュシステム
• AI アシスタント向けの MCP（Model Context Protocol）サーバー連携
• MCP サーバー向けに 3 つのツールを公開します：
  • get_weekly_club_results() 週間クラブ結果を取得します。LLM が結果を要約してレポートを作成するために使用できます
  • get_personal_events() 指定した人物 ID（設定ファイル）と期間の個人大会を取得します
  • get_detailed_result_for_event_and_person() 特定の大会と人物 ID（設定ファイル）の詳細な結果を取得します
• データを解析し、LLM が扱いやすい形式で提供することを試みます
• クライアントを単独で実行し、確認用の JSON 出力を生成するデバッグモード
• 安全にアクセスするための API キーと人物 ID の設定

インストール

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

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

2. 仮想環境を設定します：

uv venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

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

uv pip install -r requirements.txt

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

cp eventor_config_example.py eventor_config.py
# Edit eventor_config.py with your actual API key, personId, and other settings

使用方法

デバッグするには、デバッグモードで起動するだけです。結果を確認するための JSON ファイルを生成する、単独で関数を実行する main 関数があります。

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 のプライベートキー（組織の Eventor 管理者にお問い合わせください）と、ご自身のプライベート人物 ID の両方を追加してください（出力 JSON ファイルで確認できます）。

ライセンス

MIT ライセンス