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: сервер протокола контекста модели для API Hevy Fitness

Реализация сервера Model Context Protocol (MCP), которая взаимодействует с приложением для отслеживания фитнеса Hevy и его API . Этот сервер позволяет помощникам на основе ИИ получать доступ и управлять данными тренировок, программами, шаблонами упражнений и многим другим через API Hevy (требуется подписка PRO).

Функции

  • Управление тренировками : получение, создание и обновление тренировок.
  • Управление рутиной : доступ и управление рутиной тренировок
  • Шаблоны упражнений : просмотрите доступные шаблоны упражнений.
  • Организация папок : управление папками рутинных задач

Предпосылки

  • Node.js (v20 или выше)
  • нпм или пряжа
  • Ключ API Hevy

Установка

Установка через Smithery

Чтобы автоматически установить hevy-mcp для Claude Desktop через Smithery :

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

Ручная установка

# 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

Интеграция с курсором

Чтобы использовать этот сервер MCP с Cursor, вам необходимо обновить файл ~/.cursor/mcp.json , добавив следующую конфигурацию:

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

Обязательно замените your-api-key-here на ваш фактический ключ API Hevy.

Конфигурация

Создайте в корне проекта файл .env со следующим содержимым:

HEVY_API_KEY=your_hevy_api_key_here

Замените your_hevy_api_key_here на ваш фактический ключ API Hevy.

Использование

Разработка

npm run dev

Это запустит сервер MCP в режиме разработки с горячей перезагрузкой.

Производство

npm run build npm start

Доступные инструменты MCP

На сервере реализованы следующие инструменты MCP:

Инструменты для тренировок

  • get-workouts : Извлечение и форматирование данных тренировок
  • get-workout : Получить одну тренировку по ID
  • create-workout : Создать новую тренировку
  • update-workout : Обновить существующую тренировку
  • get-workout-count : Получить общее количество тренировок
  • get-workout-events : Получить обновление тренировки/удалить события

Рутинные инструменты

  • get-routines : Извлечение и форматирование данных процедуры
  • create-routine : Создать новую процедуру
  • update-routine : Обновить существующую процедуру
  • get-routine : Получить одну процедуру по идентификатору

Инструменты шаблонов упражнений

  • get-exercise-templates : Получить шаблоны упражнений
  • get-exercise-template : Получить шаблон по ID

Инструменты для папок рутины

  • get-routine-folders : Извлечь папки рутины
  • create-routine-folder : Создать новую папку
  • get-routine-folder : Получить папку по идентификатору

Структура проекта

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

Разработка

Стиль кода

В этом проекте для форматирования и линтинга кода используется Biome:

npm run check

Создание API-клиента

Клиент API создается на основе спецификации OpenAPI с использованием Kiota:

npm run export-specs npm run build:client

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Благодарности

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.

Реализация сервера Model Context Protocol (MCP), которая взаимодействует с приложением для отслеживания фитнеса Hevy и его API. Этот сервер позволяет помощникам на основе ИИ получать доступ и управлять данными тренировок, программами, шаблонами упражнений и многим другим через API Hevy (требуется подписка PRO).

  1. Функции
    1. Предпосылки
      1. Установка
        1. Установка через Smithery
        2. Ручная установка
        3. Интеграция с курсором
      2. Конфигурация
        1. Использование
          1. Разработка
          2. Производство
        2. Доступные инструменты MCP
          1. Инструменты для тренировок
          2. Рутинные инструменты
          3. Инструменты шаблонов упражнений
          4. Инструменты для папок рутины
        3. Структура проекта
          1. Разработка
            1. Стиль кода
            2. Создание API-клиента
          2. Лицензия
            1. Внося вклад
              1. Благодарности

                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