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.

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

Licencia

La Licencia Pública General GNU v3.0

Presentado

Glama.ai

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

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

Related MCP Servers

Garmin MCP Server
Taxuspt
-
security
A
license
-
quality
Connects to Garmin Connect and exposes your fitness and health data (activities, sleep, heart rate, steps, body composition) to Claude and other MCP-compatible clients.
Last updated -
1
Python
MIT License
Education Data MCP Server
ckz
-
security
A
license
-
quality
Provides access to Urban Institute's Education Data API through Claude, enabling users to query and analyze detailed educational data from schools, districts, and universities.
Last updated -
JavaScript
MIT License
Webflow MCP Server
TimKJones
-
security
A
license
-
quality
Enables Claude to interact with Webflow's APIs, allowing access to site information, collections, and other Webflow resources.
Last updated -
TypeScript
MIT License
ServiceNow MCP Server
echelon-ai-labs
A
security
A
license
A
quality
An implementation that enables Claude to connect to ServiceNow instances, retrieve data, and perform actions through the ServiceNow API.
Last updated -
62
70
Python
MIT License

View all related MCP servers

Intervals.icu MCP Server