hevy-mcp: Servidor de protocolo de contexto de modelo para la API de Hevy Fitness

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que interactúa con la aplicación de seguimiento de actividad física Hevy y su API . Este servidor permite a los asistentes de IA acceder y gestionar datos de entrenamiento, rutinas, plantillas de ejercicios y más a través de la API de Hevy (requiere suscripción PRO).

Características

• Gestión de entrenamientos : obtenga, cree y actualice entrenamientos

• Gestión de rutinas : acceda y administre sus rutinas de entrenamiento

• Plantillas de ejercicios : explore las plantillas de ejercicios disponibles

• Organización de carpetas : Administrar carpetas de rutina

Related MCP server: hevy-mcp

Prerrequisitos

• Node.js (v20 o superior)

• npm o hilo

• Una clave API de Hevy

Instalación

Instalación mediante herrería

Para instalar hevy-mcp para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @chrisdoc/hevy-mcp --client claude

Instalación manual

# Clone the repository
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp

# Install dependencies
npm install

# Create .env file from sample
cp .env.sample .env
# Edit .env and add your Hevy API key

Integración con Cursor

Para utilizar este servidor MCP con Cursor, debe actualizar su archivo ~/.cursor/mcp.json agregando la siguiente configuración:

{
  "hevy-mcp-server": {
    "command": "npx",
    "args": ["-y", "hevy-mcp"],
    "env": {
      "HEVY_API_KEY": "your-api-key-here"
    }
  }
}

Asegúrate de reemplazar your-api-key-here con tu clave API de Hevy real.

Configuración

Cree un archivo .env en la raíz del proyecto con el siguiente contenido:

HEVY_API_KEY=your_hevy_api_key_here

Reemplace your_hevy_api_key_here con su clave API de Hevy real.

Uso

Desarrollo

npm run dev

Esto inicia el servidor MCP en modo de desarrollo con recarga en caliente.

Producción

npm run build
npm start

Herramientas MCP disponibles

El servidor implementa las siguientes herramientas MCP:

Herramientas de entrenamiento

• get-workouts : Obtener y formatear datos de entrenamiento

• get-workout : Obtén un solo entrenamiento por ID

• create-workout : Crea un nuevo entrenamiento

• update-workout : Actualizar un entrenamiento existente

• get-workout-count : obtener el recuento total de entrenamientos

• get-workout-events : Obtener actualizaciones de entrenamiento/eliminar eventos

Herramientas de rutina

• get-routines : Obtener y formatear datos de rutina

• create-routine : Crea una nueva rutina

• update-routine : Actualizar una rutina existente

• get-routine : Obtener una sola rutina por ID

Herramientas de plantillas de ejercicios

• get-exercise-templates : Obtener plantillas de ejercicios

• get-exercise-template : Obtener una plantilla por ID

Herramientas de carpeta de rutina

• get-routine-folders : Obtener carpetas de rutina

• create-routine-folder : Crea una nueva carpeta

• get-routine-folder : Obtener una carpeta por ID

Estructura del proyecto

hevy-mcp/
├── .env                   # Environment variables (API keys)
├── src/
│   ├── index.ts           # Main entry point
│   ├── tools/             # Directory for MCP tool implementations
│   │   ├── workouts.ts    # Workout-related tools
│   │   ├── routines.ts    # Routine-related tools
│   │   ├── templates.ts   # Exercise template tools
│   │   └── folders.ts     # Routine folder tools
│   ├── generated/         # API client (generated code)
│   │   ├── client/        # Kiota-generated client
│   └── utils/             # Helper utilities
│       ├── formatters.ts  # Data formatting helpers
│       └── validators.ts  # Input validation helpers
├── scripts/               # Build and utility scripts
└── tests/                 # Test suite

Desarrollo

Estilo de código

Este proyecto utiliza Biome para formatear y controlar el código:

npm run check

Generando cliente API

El cliente API se genera a partir de la especificación OpenAPI utilizando Kiota:

npm run export-specs
npm run build:client

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Expresiones de gratitud

• Protocolo de contexto de modelo para el SDK de MCP

• Hevy por su plataforma de seguimiento de actividad física y API