内容
# Intervals.icu 中间件服务器
用于连接 Claude 与 Intervals.icu API 的模型上下文协议（MCP）服务器。它为活动、事件和健康数据提供身份验证和数据检索工具。
## 要求
- Python 3.10 或更高版本
- [模型上下文协议（MCP）Python SDK](https://github.com/modelcontextprotocol/python-sdk)
- httpx
- python-dotenv
## 设置
### 1. 安装 uv（推荐）
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
### 2. 克隆此仓库
```bash
git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server
```
### 3. 创建并激活虚拟环境
```bash
# 创建虚拟环境
uv venv
# 激活虚拟环境
# 在 macOS/Linux 上：
source .venv/bin/activate
# 在 Windows 上：
.venv\Scripts\activate
```
### 4. 安装依赖项
```bash
uv pip install -e .
```
### 5. 设置环境变量
复制 `.env.example` 并将其命名为 `.env`，运行以下命令：
```bash
cp .env.example .env
```
然后编辑 `.env` 文件并设置您的 Intervals.icu 运动员 ID 和 API 密钥：
```
API_KEY=您的_intervals_api_key_在此
ATHLETE_ID=您的_athlete_id_在此
```
#### 获取您的 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：
```bash
mcp install src/intervals_mcp_server/server.py --name "Intervals.icu 中间件服务器"
```
2. 如果您打开 Claude Desktop 应用配置文件 `claude_desktop_config.json`，它应如下所示：
```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` 代码文件夹的路径。
如果您在打开 Claude Desktop 时看到以下错误消息，请在 `claude_desktop_config.json` 配置文件中将 `uv` 的完整路径包含在命令键中。您可以通过在终端中运行 `which uv` 来获取 `uv` 的完整路径。
```
2025-04-28T10:21:11.462Z [info] [Intervals.icu 中间件服务器] 初始化服务器...
2025-04-28T10:21:11.477Z [error] [Intervals.icu 中间件服务器] 启动 uv ENOENT
2025-04-28T10:21:11.477Z [error] [Intervals.icu 中间件服务器] 启动 uv ENOENT
2025-04-28T10:21:11.481Z [info] [Intervals.icu 中间件服务器] 服务器传输已关闭
2025-04-28T10:21:11.481Z [info] [Intervals.icu 中间件服务器] 客户端传输已关闭
```
3. 重启 Claude Desktop。
### 2. 将中间件服务器与 Claude 一起使用
一旦服务器运行并且 Claude Desktop 已配置，您就可以使用以下工具询问有关过去和未来的活动、事件和健康数据。
- `get_activities`：检索活动列表
- `get_activity_details`：获取特定活动的详细信息
- `get_activity_intervals`：获取特定活动的详细区间数据
- `get_wellness_data`：获取健康数据
- `get_events`：检索即将到来的事件（锻炼、比赛等）
- `get_event_by_id`：获取特定事件的详细信息
## 许可证
GNU 通用公共许可证 v3.0
## 特色
### Glama.ai
<a href="https://glama.ai/mcp/servers/@mvilanova/intervals-mcp-server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@mvilanova/intervals-mcp-server/badge" alt="Intervals.icu 服务器中间件服务器" />
</a>
