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:删除事件。
