remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

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.

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

Licencia

La Licencia Pública General GNU v3.0

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Conecta a Claude con la API Intervals.icu para recuperar datos de fitness, incluidas actividades, entrenamientos, métricas de bienestar y eventos de entrenamiento.