remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Intervals.icu MCP 服务器

模型上下文协议 (MCP) 服务器，用于将 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/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server

3.创建并激活虚拟环境

# Create virtual environment
uv venv

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On 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

当您登录 Intervals.icu 时，您的运动员 ID 通常会显示在 URL 中。它看起来像：

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

用法

1.配置Claude桌面

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

从intervals_mcp_server目录运行以下命令来配置 Claude Desktop：

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"

如果您打开 Claude 桌面应用程序配置文件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。

2. 使用 Claude 的 MCP 服务器

一旦服务器运行并且 Claude Desktop 配置完成，您可以使用以下工具询问有关您过去和未来的活动、事件和健康数据的问题。

get_activities ：检索活动列表
get_activity_details ：获取特定活动的详细信息
get_activity_intervals ：获取特定活动的详细间隔数据
get_wellness_data ：获取健康数据
get_events ：检索即将发生的事件（锻炼、比赛等）
get_event_by_id ：获取特定事件的详细信息

执照

GNU 通用公共许可证 v3.0

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

将 Claude 与 Intervals.icu API 连接起来以检索健身数据，包括活动、锻炼、健康指标和训练事件。