Mvilanova Intervals MCP Server

🚀 Intervals.icu MCP 服務器

該MCP（模型上下文協議）服務器的主要作用是將Claude與Intervals.icu API連接起來。它為用戶提供了身份驗證功能，同時還具備活動、事件以及健康數據檢索的工具，極大地方便了相關數據的獲取與管理。

🚀 快速開始

本部分將引導您完成Intervals.icu MCP服務器的安裝、配置和使用，讓您能夠快速將其與Claude Desktop集成，實現活動、事件及健康數據的檢索。

✨ 主要特性

• 連接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/yourusername/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 Desktop配置中。

配置命令

在intervals_mcp_server目錄下運行以下命令以配置Claude Desktop：

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP 服務器"

配置文件示例

如果打開您的Claude Desktop應用配置文件claude_desktop_config.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使配置生效。

2. 使用MCP服務器與Claude

一旦服務器運行且Claude Desktop配置完成，您可以使用以下工具查詢過去的和未來的活動、事件及健康數據。

• get_activities：檢索活動列表
• get_activity_details：獲取特定活動的詳細信息
• get_activity_intervals：獲取特定活動的詳細區間數據
• get_wellness_data：提取健康數據
• get_events：檢索即將舉行的事件（訓練、比賽等）
• get_event_by_id：獲取特定事件的詳細信息

📄 許可證

GNU通用公共許可證第3.0版