Eventor MCP Server

🚀 Eventor API 客戶端

Eventor API 客戶端是一個Python工具，專為與Eventor定向 API 集成而設計。它能讓用戶輕鬆訪問活動、參賽者和結果數據，為相關數據的獲取和處理提供了便利。

✨ 主要特性

• 豐富的數據訪問：可訪問活動結果、參賽者和組織信息。
• 高效的緩存機制：具備可配置緩存系統，能有效減少API調用次數。
• AI助手集成：支持MCP（模型上下文協議）服務器集成，方便AI助手使用。
• 實用工具集合：提供3個實用工具供MCP服務器使用：
  • 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文件查找）。