Intervals.icu MCP 服务器

该MCP（Model Context Protocol）服务器用于将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密钥

1. 登录到您的Intervals.icu账户
2. 转到设置 > API
3. 生成新的API密钥

查找您的运动员ID

您的运动员ID通常在您登录Intervals.icu时显示在URL中，格式如下：

• https://intervals.icu/athlete/i12345/... 其中 i12345 是您的运动员ID

使用方法

1. 配置Claude Desktop

要将此服务器与Claude Desktop一起使用，需将其添加到Claude Desktop配置中。

1. 在intervals_mcp_server目录下运行以下命令以配置Claude Desktop：

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP 服务器"

2. 如果打开您的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代码文件夹的路径。

3. 重启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版