AI导哈

Intervals.icu MCP服务器

Intervals.icu MCP服务器是一个用于与Intervals.icu数据交互的协议服务器，支持活动、健康数据和日历事件的管理。

  • by moxus
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 moxus/intervals-icu-mcp-ts

使用说明

Intervals.icu MCP服务器

这是一个模型上下文协议（MCP）服务器，用于 间隔icu。它允许您与您的Intervals.icu数据进行交互，包括活动、健康数据和日历事件。

配置

您需要Intervals.icu中的API密钥和运动员ID。

环境变量

变量 描述
INTERVALS_ATHLETE_ID 您的Intervals.icu运动员ID（例如。， i12345)
INTERVALS_API_KEY 您的Intervals.icu API密钥

设置环境变量

macOS/Linux

您可以在终端会话中设置环境变量或将其添加到shell配置文件中（例如。， .bashrc, .zshrc).

export INTERVALS_ATHLETE_ID="your_athlete_id"
export INTERVALS_API_KEY="your_api_key"

要使它们永久存在，请将上面的线条添加到您的 ~/.zshrc 或 ~/.bashrc 文件并运行 source ~/.zshrc （或 source ~/.bashrc).

Windows（命令提示符）

set INTERVALS_ATHLETE_ID=your_athlete_id
set INTERVALS_API_KEY=your_api_key

注意：这仅设置当前会话的变量。要永久设置它们，请使用“系统属性”对话框或 setx.

Windows（PowerShell）

$env:INTERVALS_ATHLETE_ID="your_athlete_id"
$env:INTERVALS_API_KEY="your_api_key"

要永久设置它们，请执行以下操作：

[System.Environment]::SetEnvironmentVariable('INTERVALS_ATHLETE_ID', 'your_athlete_id', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('INTERVALS_API_KEY', 'your_api_key', [System.EnvironmentVariableTarget]::User)

用法

使用软件包运行服务器：

npx @moxus/intervals-mcp

或者，如果从源代码运行：

node dist/index.js

验证命令

您可以使用以下工具验证您的配置和与Intervals.icu的连接 verify 命令。这将尝试获取您的运动员资料。

npx @moxus/intervals-mcp verify

如果成功，您将看到您的运动员详细信息。如果失败，请检查您的API密钥和运动员ID。

Gemini安装

为Gemini安装此MCP服务器的最简单方法是使用扩展：

gemini extension install https://github.com/moxus/intervals-icu-gemini

有关更多详细信息，请参阅 Intervals.icu Gemini扩展库.

手动配置（备选）

将此MCP服务器添加到CLI代理，如 gemini-cli （或支持MCP的类似代理）手动，您通常需要配置代理以生成此服务器进程。

假设 gemini-cli 支持MCP配置文件（如 mcp_config.json 或者命令行参数），您可以添加一个条目 @moxus/intervals-mcp.

示例配置（概念性）：

{
  "mcpServers": {
    "intervals": {
      "command": "npx",
      "args": ["-y", "@moxus/intervals-mcp"],
      "env": {
        "INTERVALS_ATHLETE_ID": "your_athlete_id",
        "INTERVALS_API_KEY": "your_api_key"
      }
    }
  }
}

或者，如果您从源代码本地运行它：

{
  "mcpServers": {
    "intervals": {
      "command": "node",
      "args": ["/path/to/intervals-icu-mcp-ts/dist/index.js"],
      "env": {
        "INTERVALS_ATHLETE_ID": "your_athlete_id",
        "INTERVALS_API_KEY": "your_api_key"
      }
    }
  }
}

有关确切的配置格式，请参阅您正在使用的特定代理的文档。

工具

  • get_athlete_profile：获取运动员详细信息。
  • list_activities：获取日期范围内的活动。
  • get_activity：获取活动的完整细节。
  • list_wellness：获取健康日志。
  • list_workouts：从图书馆获取锻炼。
  • create_workout：在库中创建锻炼。
  • list_events：获取日历事件。
  • create_event：在日历上创建活动（锻炼、笔记等）。
  • update_event：更新现有事件。
  • delete_future_event：删除事件。

相关 MCP