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文件查找）。