Intervals.icu MCP Server
2025.04.04
0
Python运动数据分析健康追踪训练管理日程管理
Intervals.icu MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于连接 Claude 与 Intervals.icu API。它提供了认证和数据检索工具，用于获取活动、事件和健康数据。
View on GitHub
Overview
基本能力
产品定位
Intervals.icu MCP Server 是一个中间件服务，旨在通过 MCP 协议连接 Claude 与 Intervals.icu API，实现数据的无缝交互。
核心功能
- 提供与 Intervals.icu API 的认证功能
- 支持多种数据检索功能，包括活动、事件和健康数据
- 提供工具集，方便用户查询和管理个人运动数据
适用场景
- 运动数据分析与可视化
- 训练计划管理
- 健康数据追踪
- 赛事和活动管理
工具列表
get_activities: 获取活动列表get_activity_details: 获取特定活动的详细信息get_activity_intervals: 获取特定活动的详细间隔数据get_wellness_data: 获取健康数据get_events: 获取即将到来的事件（训练、比赛等）get_event_by_id: 获取特定事件的详细信息
常见问题解答
- 如何获取 API Key？
- 登录 Intervals.icu 账户
- 转到 设置 > API
-
生成新的 API Key
-
如何找到 Athlete ID？
- 登录 Intervals.icu 后，在 URL 中查找类似
i12345的 ID
使用教程
使用依赖
- Python 3.10 或更高版本
- Model Context Protocol (MCP) Python SDK
- httpx
- python-dotenv
安装教程
- 安装 uv（推荐）
curl -LsSf https://astral.sh/uv/install.sh | sh
- 克隆仓库
git clone https://github.com/yourusername/intervals-mcp-server.git
cd intervals-mcp-server
- 创建并激活虚拟环境
# 创建虚拟环境
uv venv
# 激活虚拟环境
# macOS/Linux:
source .venv/bin/activate
# Windows:
.venv\Scripts\activate
- 安装依赖
uv pip install -e .
- 设置环境变量
cp .env.example .env
编辑 .env 文件设置 API_KEY 和 ATHLETE_ID
调试方式
- 配置 Claude Desktop
mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"
-
检查配置文件
claude_desktop_config.json是否正确 -
重启 Claude Desktop