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: Model Context Protocol Server für die Hevy Fitness API

Eine Serverimplementierung des Model Context Protocol (MCP), die mit der Hevy Fitness-Tracking-App und ihrer API interagiert. Dieser Server ermöglicht KI-Assistenten den Zugriff auf und die Verwaltung von Trainingsdaten, Routinen, Übungsvorlagen und mehr über die Hevy-API (erfordert PRO-Abonnement).

Merkmale

  • Trainingsverwaltung : Trainings abrufen, erstellen und aktualisieren
  • Routineverwaltung : Zugriff auf Trainingsroutinen und deren Verwaltung
  • Übungsvorlagen : Durchsuchen Sie die verfügbaren Übungsvorlagen
  • Ordnerorganisation : Routineordner verwalten

Voraussetzungen

  • Node.js (v20 oder höher)
  • npm oder yarn
  • Ein Hevy-API-Schlüssel

Installation

Installation über Smithery

So installieren Sie hevy-mcp für Claude Desktop automatisch über Smithery :

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

Manuelle Installation

# 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

Integration mit Cursor

Um diesen MCP-Server mit Cursor zu verwenden, müssen Sie Ihre Datei ~/.cursor/mcp.json aktualisieren, indem Sie die folgende Konfiguration hinzufügen:

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

Stellen Sie sicher, dass Sie your-api-key-here durch Ihren tatsächlichen Hevy-API-Schlüssel ersetzen.

Konfiguration

Erstellen Sie im Projektstammverzeichnis eine .env Datei mit folgendem Inhalt:

HEVY_API_KEY=your_hevy_api_key_here

Ersetzen Sie your_hevy_api_key_here durch Ihren tatsächlichen Hevy-API-Schlüssel.

Verwendung

Entwicklung

npm run dev

Dadurch wird der MCP-Server im Entwicklungsmodus mit Hot Reloading gestartet.

Produktion

npm run build npm start

Verfügbare MCP-Tools

Der Server implementiert die folgenden MCP-Tools:

Trainingstools

  • get-workouts : Trainingsdaten abrufen und formatieren
  • get-workout : Holen Sie sich ein einzelnes Training nach ID
  • create-workout : Erstelle ein neues Training
  • update-workout : Aktualisieren Sie ein vorhandenes Training
  • get-workout-count : Ruft die Gesamtzahl der Trainingseinheiten ab
  • get-workout-events : Trainingsaktualisierungs-/Löschereignisse abrufen

Routinewerkzeuge

  • get-routines : Routinedaten abrufen und formatieren
  • create-routine : Eine neue Routine erstellen
  • update-routine : Aktualisieren Sie eine vorhandene Routine
  • get-routine : Ruft eine einzelne Routine nach ID ab

Übungsvorlagen-Tools

  • get-exercise-templates : Übungsvorlagen abrufen
  • get-exercise-template : Holen Sie sich eine Vorlage nach ID

Routine-Ordner-Tools

  • get-routine-folders : Routineordner abrufen
  • create-routine-folder : Einen neuen Ordner erstellen
  • get-routine-folder : Holen Sie sich einen Ordner nach ID

Projektstruktur

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

Entwicklung

Codestil

Dieses Projekt verwendet Biome zur Codeformatierung und zum Lint-Test:

npm run check

API-Client generieren

Der API-Client wird mithilfe von Kiota aus der OpenAPI-Spezifikation generiert:

npm run export-specs npm run build:client

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Danksagung

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.

Eine Model Context Protocol (MCP)-Serverimplementierung, die mit der Hevy Fitness-Tracking-App und ihrer API interagiert. Dieser Server ermöglicht KI-Assistenten den Zugriff auf und die Verwaltung von Trainingsdaten, Routinen, Übungsvorlagen und mehr über die Hevy-API (PRO-Abonnement erforderlich).

  1. Merkmale
    1. Voraussetzungen
      1. Installation
        1. Installation über Smithery
        2. Manuelle Installation
        3. Integration mit Cursor
      2. Konfiguration
        1. Verwendung
          1. Entwicklung
          2. Produktion
        2. Verfügbare MCP-Tools
          1. Trainingstools
          2. Routinewerkzeuge
          3. Übungsvorlagen-Tools
          4. Routine-Ordner-Tools
        3. Projektstruktur
          1. Entwicklung
            1. Codestil
            2. API-Client generieren
          2. Lizenz
            1. Beitragen
              1. Danksagung

                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
                  F
                  license
                  -
                  quality
                  Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
                  Last updated -
                  90
                  Python
                  • Apple
                  • Linux
                • -
                  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

                View all related MCP servers

                ID: vl8qtbflvm