Сервер Govee MCP

MCP-сервер для управления светодиодными устройствами Govee через API Govee.

Настраивать

Переменные среды

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

GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here

Чтобы получить эти значения:

1. Получите свой ключ API на портале разработчиков Govee

2. Используйте приложение Govee Home, чтобы найти идентификатор и артикул вашего устройства.

Related MCP server: ESP RainMaker MCP Server

Установка

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

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

npx -y @smithery/cli install @mathd/govee_mcp_server --client claude

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

# Install with pip
pip install .

# For development (includes test dependencies)
pip install -e ".[test]"

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

MCP-сервер

Сервер MCP предоставляет инструменты для управления устройствами Govee через Model Context Protocol. Его можно использовать с Cline или другими клиентами MCP.

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

• turn_on_off : Включить или выключить светодиод

• set_color : Установить цвет светодиода с использованием значений RGB

• set_brightness : Установить уровень яркости светодиода

Интерфейс командной строки

Для прямого управления устройствами Govee предусмотрен интерфейс командной строки:

# Turn device on/off
govee-cli power on
govee-cli power off

# Set color using RGB values (0-255)
govee-cli color 255 0 0  # Red
govee-cli color 0 255 0  # Green
govee-cli color 0 0 255  # Blue

# Set brightness (0-100)
govee-cli brightness 50

Запустите govee-cli --help для получения полной документации по команде.

Разработка

Проведение тестов

Чтобы запустить тестовый набор:

# Install test dependencies
pip install -e ".[test]"

# Run all tests
pytest tests/

# Run specific test files
pytest tests/test_server.py  # Server tests (mocked API calls)
pytest tests/test_cli.py    # CLI tests (real API calls)

# Run tests with verbose output
pytest tests/ -v

Примечание: тесты CLI выполняют реальные вызовы API к вашему устройству Govee и фактически управляют им. Перед запуском этих тестов убедитесь, что ваше устройство включено и подключено.

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

.
├── src/govee_mcp_server/
│   ├── __init__.py
│   ├── server.py    # MCP server implementation
│   └── cli.py       # Command-line interface
├── tests/
│   ├── test_server.py  # Server tests (with mocked API)
│   └── test_cli.py     # CLI tests (real API calls)
└── pyproject.toml      # Project configuration

Тестовое покрытие

• Тесты сервера охватывают:

  • Инициализация среды

  • Методы клиента API Govee

  • Серверные инструменты и утилиты

  • Обработка ошибок

• Тесты CLI выполняют реальное интеграционное тестирование, выполняя реальные вызовы API для управления вашим устройством Govee.