Intervals MCP Server

🚀 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密鑰

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的配置文件中。

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 協議。