hevy-mcp: сервер протокола контекста модели для API Hevy Fitness

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

Функции

• Управление тренировками : получение, создание и обновление тренировок.

• Управление рутиной : доступ и управление рутиной тренировок

• Шаблоны упражнений : просмотрите доступные шаблоны упражнений.

• Организация папок : управление папками рутинных задач

Related MCP server: AgentMode

Предпосылки

• Node.js (v20 или выше)

• npm или пряжа

• Ключ 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.

Внося вклад

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

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

• Модель контекстного протокола для MCP SDK

• Hevy за свою платформу для отслеживания фитнеса и API