Intervals.icu MCP 服务器

用于连接 Claude 与 Intervals.icu API 的模型上下文协议（MCP）服务器。它提供了用于身份验证和获取活动、事件和健康数据的工具。

要求

• Python 3.12 或更高版本
• 模型上下文协议（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. 创建并激活虚拟环境

# 使用 Python 3.12 创建虚拟环境
uv venv --python 3.12

# 激活虚拟环境
# 在 macOS/Linux 上：
source .venv/bin/activate
# 在 Windows 上：
.venv\Scripts\activate

4. 同步项目依赖

uv sync

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. 从 main 分支拉取最新更改

⚠️ 在运行此命令之前，请确保你没有未提交的更改。

git checkout main && git pull

2. 更新 Python 依赖

激活你的虚拟环境并同步依赖：

source .venv/bin/activate
uv sync

故障排除

如果 Claude Desktop 由于配置更改而失败，请按照以下步骤操作：

1. 删除 claude_desktop_config.json 中的现有条目。
2. 从 intervals_mcp_server 目录重新配置 Claude Desktop：

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu" --with-editable . --env-file .env

使用

1. 配置 Claude Desktop

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

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

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu" --with-editable . --env-file .env

2. 如果你打开你的 Claude Desktop 应用配置文件 claude_desktop_config.json，它应该看起来像这样：

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "/Users/<USERNAME>/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/intervals-mcp-server",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ],
      "env": {
        "INTERVALS_API_BASE_URL": "https://intervals.icu/api/v1",
        "ATHLETE_ID": "<YOUR_ATHLETE_ID>",
        "API_KEY": "<YOUR_API_KEY>",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

其中 /path/to/ 是你系统中 intervals-mcp-server 代码文件夹的路径。

如果你在打开 Claude Desktop 时观察到以下错误消息，请在 claude_desktop_config.json 配置文件中的命令键中包含 uv 的完整路径。你可以通过在终端中运行 which uv 来获取完整路径。

2025-04-28T10:21:11.462Z [info] [Intervals.icu MCP Server] Initializing server...
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Server transport closed
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Client transport closed

3. 重新启动 Claude Desktop。

2. 与 Claude 一起使用 MCP 服务器

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

• get_activities：获取活动列表
• get_activity_details：获取特定活动的详细信息
• get_activity_intervals：获取特定活动的详细间隔数据
• get_wellness_data：获取健康数据
• get_events：获取即将到来的事件（训练、比赛等）
• get_event_by_id：获取特定事件的详细信息

开发和测试

安装开发依赖并运行测试套件：

uv sync --all-extras
pytest -v tests

在本地运行服务器

要手动启动服务器（在开发或测试时很有用），请运行：

mcp run src/intervals_mcp_server/server.py

许可证

GNU 通用公共许可证 v3.0

推荐

Glama.ai