Intervals.icu MCP 服务器

用于将 Claude 连接到 Intervals.icu API 的模型上下文协议 (MCP) 服务器。它为活动、事件和健康数据的身份验证和数据检索提供工具。

要求

• 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 Server"

2. 如果您打开您的 Claude Desktop App 配置文件 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 General Public License v3.0