Skip to main content
Glama
deenesjakoruzh

Hevy MCP

by chrisdoc
npmGitHub
TypeScript
MIT License
353
26
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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

How are these scores calculated?

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

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

                • FastAPI MCP Server

                  purity3
                  -
                  security
                  A
                  license
                  -
                  quality
                  A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
                  Last updated -
                  2
                  Python
                  MIT License

                • AgentModeofficial

                  agentmode
                  A
                  security
                  F
                  license
                  A
                  quality
                  An all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.
                  Last updated -
                  2
                  Python
                  • Apple
                  • Linux

                • Teambition MCP Server

                  shenysun
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol (MCP) server that provides AI capabilities to Teambition applications, enabling programmatic access to user management, organization data, and project collaboration features through natural language.
                  Last updated -
                  TypeScript
                  MIT License

                • OpenAPI MCP Server

                  oneWalker
                  -
                  security
                  A
                  license
                  -
                  quality
                  A server that implements the Model Context Protocol (MCP) with StreamableHTTP transport, enabling standardized interaction with model services through a RESTful API interface.
                  Last updated -
                  155
                  1
                  JavaScript
                  MIT License

                View all related MCP servers

                Appeared in Searches

                New 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