Servidor MCP de Intervals.icu

Servidor de Protocolo de Contexto de Modelo (MCP) para conectar a Claude con la API de Intervals.icu. Proporciona herramientas para la autenticación y la recuperación de datos de actividades, eventos y bienestar.

Requisitos

Python 3.10 o superior
SDK de Python del Protocolo de Contexto de Modelo (MCP)
httpx
python-dotenv

Related MCP server: Education Data MCP Server

Configuración

1. Instalar uv (recomendado)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clonar este repositorio

git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server

3. Crear y activar un entorno virtual

# Create virtual environment
uv venv

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

4. Instalar dependencias

uv pip install -e .

5. Configurar variables de entorno

Haga una copia de .env.example y llámela .env ejecutando el siguiente comando:

cp .env.example .env

Luego edite el archivo .env y configure su ID de atleta y clave API de Intervals.icu:

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Cómo obtener su clave API de Intervals.icu

Inicie sesión en su cuenta de Intervals.icu
Vaya a Configuración > API
Generar una nueva clave API

Cómo encontrar tu ID de atleta

Tu ID de atleta suele estar visible en la URL al iniciar sesión en Intervals.icu. Su aspecto es el siguiente:

https://intervals.icu/athlete/i12345/... donde i12345 es su ID de atleta

Uso

1. Configurar Claude Desktop

Para utilizar este servidor con Claude Desktop, debe agregarlo a su configuración de Claude Desktop.

Ejecute lo siguiente desde el directorio intervals_mcp_server para configurar Claude Desktop:

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"

Si abre el archivo de configuración de la aplicación Claude Desktop claude_desktop_config.json , debería verse así:

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ]
    }
  }
}

Donde /path/to/ es la ruta a la carpeta de código intervals-mcp-server en su sistema.

Si observa los siguientes mensajes de error al abrir Claude Desktop, incluya la ruta completa a uv en la clave de comando del archivo de configuración claude_desktop_config.json . Puede obtener la ruta completa ejecutando which uv en la terminal.

2025-04-28T10:21:11.462Z [info] [Intervals.icu MCP Server] Initializing server...
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.477Z [error] [Intervals.icu MCP Server] spawn uv ENOENT
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Server transport closed
2025-04-28T10:21:11.481Z [info] [Intervals.icu MCP Server] Client transport closed

Reinicie Claude Desktop.

2. Utilice el servidor MCP con Claude

Una vez que el servidor esté en funcionamiento y Claude Desktop esté configurado, puede utilizar las siguientes herramientas para hacer preguntas sobre sus actividades pasadas y futuras, eventos y datos de bienestar.

get_activities : Recuperar una lista de actividades
get_activity_details : Obtener información detallada de una actividad específica
get_activity_intervals : Obtener datos de intervalo detallados para una actividad específica
get_wellness_data : Obtener datos de bienestar
get_events : recupera los próximos eventos (entrenamientos, carreras, etc.)
get_event_by_id : Obtener información detallada de un evento específico