Skip to main content
Glama
Sign In
enesjakozh

Hevy MCP

by chrisdoc
Verified
npmGitHub
TypeScript
MIT License
84
3
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

Integrations

  • Used for environment variable configuration to store the Hevy API key.

  • Utilized for code formatting and linting in the development process of the MCP server.

  • Used for version control of the MCP server codebase.

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

View all tools

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).

  1. Features
    1. Prerequisites
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
        3. Integration with Cursor
      2. Configuration
        1. Usage
          1. Development
          2. Production
        2. Available MCP Tools
          1. Workout Tools
          2. Routine Tools
          3. Exercise Template Tools
          4. Routine Folder Tools
        3. Project Structure
          1. Development
            1. Code Style
            2. Generating API Client
          2. License
            1. Contributing
              1. Acknowledgements
                ID: vl8qtbflvm