🚀 Intervals.icu MCP 服务器
该MCP（模型上下文协议）服务器的主要作用是将Claude与Intervals.icu API连接起来。它为用户提供了身份验证功能，同时还具备活动、事件以及健康数据检索的工具，极大地方便了相关数据的获取与管理。
🚀 快速开始
本部分将引导您完成Intervals.icu MCP服务器的安装、配置和使用，让您能够快速将其与Claude Desktop集成，实现活动、事件及健康数据的检索。
✨ 主要特性
- 连接Claude与Intervals.icu API：实现两者之间的数据交互。
- 身份验证：保障数据访问的安全性。
- 数据检索工具：可查询过去和未来的活动、事件及健康数据。
📦 安装指南
要求
- Python 3.10或更高版本
- 模型上下文协议（MCP）Python SDK
- httpx
- python-dotenv
安装步骤
1. 安装uv（推荐）
curl -LsSf https://astral.sh/uv/install.sh | sh
2. 克隆此仓库
git clone https://github.com/yourusername/intervals-mcp-server.git
cd intervals-mcp-server
3. 创建并激活虚拟环境
# 创建虚拟环境
uv venv
# 激活虚拟环境
# 在macOS/Linux上：
source .venv/bin/activate
# 在Windows上：
.venv\Scripts\activate
4. 安装依赖项
uv pip install -e .
5. 设置环境变量
复制.env.example并将其命名为.env：
cp .env.example .env
然后编辑.env文件并设置您的Intervals.icu运动员ID和API密钥：
API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here
获取您的Intervals.icu API密钥
- 登录到您的Intervals.icu账户。
- 转到设置 > API。
- 生成新的API密钥。
查找您的运动员ID
您的运动员ID通常在您登录Intervals.icu时显示在URL中，格式如下：
https://intervals.icu/athlete/i12345/...其中i12345是您的运动员ID
💻 使用示例
1. 配置Claude Desktop
要将此服务器与Claude Desktop一起使用，需将其添加到Claude Desktop配置中。
配置命令
在intervals_mcp_server目录下运行以下命令以配置Claude Desktop：
mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP 服务器"
配置文件示例
如果打开您的Claude Desktop应用配置文件claude_desktop_config.json，应如下所示：
{
"mcpServers": {
"Intervals.icu": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
]
}
}
}
其中/path/to/是您系统中intervals-mcp-server代码文件夹的路径。
重启Claude Desktop
完成上述配置后，重启Claude Desktop使配置生效。
2. 使用MCP服务器与Claude
一旦服务器运行且Claude Desktop配置完成，您可以使用以下工具查询过去的和未来的活动、事件及健康数据。
get_activities：检索活动列表get_activity_details：获取特定活动的详细信息get_activity_intervals：获取特定活动的详细区间数据get_wellness_data：提取健康数据get_events：检索即将举行的事件（训练、比赛等）get_event_by_id：获取特定事件的详细信息
📄 许可证
GNU通用公共许可证第3.0版