Eventor API Client
2025.04.24
0
Python定向运动数据AI助手集成位置服务
Eventor API Client 是一个Python客户端，用于与Eventor定向运动API集成，提供对事件、参赛者和结果的访问。该服务通过MCP（Model Context Protocol）服务器集成，为AI助手提供支持，并提供了多种工具来获取和处理定向运动数据。
View on GitHub
Overview
基本能力
产品定位
Eventor API Client 是一个用于定向运动数据访问和处理的Python客户端，特别适合需要集成定向运动数据的AI助手和开发者。
核心功能
- 访问事件结果、参赛者和组织数据
- 可配置的缓存系统，减少API调用
- MCP服务器集成，支持AI助手
- 提供三种工具：
get_weekly_club_results()：获取每周俱乐部结果，可用于LLM生成报告get_personal_events()：获取特定personId和时间段内的个人事件get_detailed_result_for_event_and_person()：获取特定事件和personId的详细结果- 数据解析，以LLM友好的格式提供数据
- 调试模式，可独立运行并生成JSON输出
- 可配置的API密钥和personId，确保安全访问
适用场景
- 定向运动俱乐部的结果汇总和报告生成
- 个人定向运动数据的分析和展示
- AI助手集成定向运动数据
使用教程
使用依赖
- 克隆仓库：
git clone https://github.com/grapatin/eventor-mcp-server.git
cd eventor-mcp-server
- 设置虚拟环境：
uv venv .venv
source .venv/bin/activate # Windows用户使用：.venv\Scripts\activate
- 安装依赖：
uv pip install -r requirements.txt
- 配置API密钥：
cp eventor_config_example.py eventor_config.py
# 编辑eventor_config.py，填入实际的API密钥、personId和其他设置
安装教程
- 按照上述依赖步骤完成环境设置和依赖安装。
- 配置
eventor_config.py文件。
调试方式
在调试模式下运行：
python -m eventor
安装MCP服务器
将以下内容添加到cluade_desktopr_config.json：
"Eventor Results API": {
"command": "uv",
"args": [
"--directory",
"/path/eventor-mcp-server",
"run",
"mcp",
"run",
"mcp_server.py"
]
}
常见问题解答
- 如何获取API密钥和personId？ 需要联系Eventor组织管理员获取API密钥，personId可以在输出JSON文件中找到。
- 如何配置缓存系统？
在
eventor_config.py中配置缓存相关参数。 - 如何运行独立调试？
使用
python -m eventor命令运行调试模式。