Сервер Govee MCP

Name: Govee MCP Server
Author: mathd

значок кузнеца

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

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

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

Related MCP server: OpenHue 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.