Govee MCP Server

Govee MCP 服务

用于通过 Govee API 控制 Govee LED 设备的 MCP 服务。

设置

环境变量

在根目录中创建 .env 文件，并添加以下变量：

GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here

获取这些值的方法：

1. 从 Govee Developer Portal 获取 API 密钥
2. 使用 Govee Home 应用查找设备 ID 和 SKU

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Govee MCP 服务：

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 服务通过 Model Context Protocol 提供用于控制 Govee 设备的工具。它可以与 Cline 或其他 MCP 客户端搭配使用。

可用工具：

• turn_on_off：打开或关闭 LED
• set_color：使用 RGB 值设置 LED 颜色
• set_brightness：设置 LED 亮度

命令行界面

提供了用于直接控制 Govee 设备的 CLI：

# 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 测试会对 Govee 设备进行真实 API 调用，并实际控制设备。运行这些测试前，请确保设备已通电并连接。

项目结构

.
├── 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

测试覆盖范围

• 服务测试涵盖：

  • 环境初始化
  • Govee API 客户端方法
  • 服务工具和实用程序
  • 错误处理

• CLI 测试通过执行实际 API 调用来控制 Govee 设备，进行真实场景集成测试。