🚀 Intervals.icu MCP 服务器
模型上下文协议（MCP）服务器的作用是将Claude与Intervals.icu API进行连接。它提供了一系列工具，可用于实现身份验证，以及对活动、事件和健康数据的检索。
🚀 快速开始
本服务器可将Claude与Intervals.icu API相连，借助相关工具实现身份验证和数据检索。以下为详细使用步骤。
✨ 主要特性
- 实现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. 创建并激活虚拟环境
# 创建虚拟环境
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密钥
- 登录到您的Intervals.icu账户。
- 转到设置 > API。
- 生成新的API密钥。
查找您的运动员ID
您的运动员ID通常在您登录到Intervals.icu时显示在URL中，形式如下：
https://intervals.icu/athlete/i12345/...其中i12345是您的运动员ID
💻 使用示例
基础用法
1. 配置Claude Desktop
要将此服务器与Claude Desktop一起使用，您需要将其添加到Claude的配置文件中。
mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"
如果打开您的Claude Desktop配置文件claude_desktop_config.json，它应该如下所示：
{
"servers": {
"intervals-mcp-server": {
"type": "stdio",
"command": "python3",
"args": ["-m", "mcp.cli.run_server", "--server-id=intervals-mcp-server"],
"cwd": "${fileDirname}"
}
},
"default-runtime": "node"
}
2. 在Claude中使用
配置完成后，您可以通过以下命令在Claude中使用：
claude config set --server=intervals-mcp-server
然后您就可以开始使用提供的工具了。
📄 许可证
本项目采用 Apache 2.0 协议。