Skip to main content
Glama

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

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.

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. Características
    1. Prerrequisitos
      1. Instalación
        1. Instalación mediante herrería
        2. Instalación manual
        3. Integración con Cursor
      2. Configuración
        1. Uso
          1. Desarrollo
          2. Producción
        2. Herramientas MCP disponibles
          1. Herramientas de entrenamiento
          2. Herramientas de rutina
          3. Herramientas de plantillas de ejercicios
          4. Herramientas de carpeta de rutina
        3. Estructura del proyecto
          1. Desarrollo
            1. Estilo de código
            2. Generando cliente API
          2. Licencia
            1. Contribuyendo
              1. Expresiones de gratitud

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
                  Last updated -
                  4
                  3
                  TypeScript
                  MIT License
                • -
                  security
                  A
                  license
                  -
                  quality
                  MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
                  Last updated -
                  13
                  2
                  TypeScript
                  MIT License
                • -
                  security
                  -
                  license
                  -
                  quality
                  A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
                  Last updated -
                  2
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides access to Crunchbase data for AI assistants. This server allows AI assistants to search for companies, get company details, funding information, acquisitions, and people data from Crunchbase.
                  Last updated -
                  5
                  3
                  JavaScript
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrisdoc/hevy-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server