Intervals.icu MCP Server
2025.04.18
14
Python运动数据管理健康数据分析日程管理
Intervals.icu MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于连接 Claude 与 Intervals.icu API。它提供了认证和数据检索工具，用于获取活动、事件和健康数据。
View on GitHub
Overview
基本能力
产品定位
Intervals.icu MCP Server 是一个用于连接 Claude 与 Intervals.icu API 的中间件服务，主要用于管理和检索用户的运动活动、事件和健康数据。
核心功能
- 提供与 Intervals.icu API 的认证和数据检索功能
- 支持获取活动列表、活动详情、活动间隔数据
- 支持获取健康数据和事件信息
适用场景
- 运动爱好者管理自己的活动数据
- 教练或团队管理运动员的训练计划
- 健康数据分析和个人健康管理
工具列表
get_activities: 获取活动列表get_activity_details: 获取特定活动的详细信息get_activity_intervals: 获取特定活动的间隔数据get_wellness_data: 获取健康数据get_events: 获取即将到来的事件get_event_by_id: 获取特定事件的详细信息
常见问题解答
- 如何获取 Intervals.icu API Key?
- 登录 Intervals.icu 账户
- 进入 Settings > API
-
生成新的 API Key
-
如何找到 Athlete ID?
- 登录 Intervals.icu 后，URL 中会显示 athlete ID，格式为
i12345
使用教程
使用依赖
- 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 文件，设置 Intervals.icu 的 athlete id 和 API key
调试方式
- 配置 Claude Desktop
mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"
-
检查 Claude Desktop 配置文件
claude_desktop_config.json是否正确 -
重启 Claude Desktop