Govee MCP 服务器

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

设置

环境变量

在根目录下创建一个 .env 文件，并包含以下变量：

bash GOVEE_API_KEY=your_api_key_here GOVEE_DEVICE_ID=your_device_id_here GOVEE_SKU=your_device_sku_here

获取这些值的方法：

1. 从 Govee 开发者门户获取您的 API 密钥
2. 使用 Govee Home 应用程序找到您的设备 ID 和 SKU

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Govee MCP 服务器，请运行：

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

手动安装

bash

使用 pip 安装

pip install .

开发环境（包括测试依赖项）

pip install -e ".[test]"

使用

MCP 服务器

MCP 服务器提供了通过 Model Context Protocol 控制 Govee 设备的工具。它可以与 Cline 或其他 MCP 客户端一起使用。

可用工具：

• turn_on_off: 开启或关闭 LED
• set_color: 使用 RGB 值设置 LED 颜色
• set_brightness: 设置 LED 亮度级别

命令行界面

提供了一个命令行界面，可以直接控制 Govee 设备：

bash

开启/关闭设备

govee-cli power on govee-cli power off

使用 RGB 值（0-255）设置颜色

govee-cli color 255 0 0 # 红色 govee-cli color 0 255 0 # 绿色 govee-cli color 0 0 255 # 蓝色

设置亮度（0-100）

govee-cli brightness 50

运行 govee-cli --help 查看完整的命令文档。

开发

运行测试

要运行测试套件：

bash

安装测试依赖项

pip install -e ".[test]"

运行所有测试

pytest tests/

运行特定测试文件

pytest tests/test_server.py # 服务器测试（模拟 API 调用） pytest tests/test_cli.py # CLI 测试（真实 API 调用）

以详细输出运行测试

pytest tests/ -v

注意：CLI 测试会向您的 Govee 设备发出真实的 API 调用并实际控制它。请确保在运行这些测试之前，您的设备已通电并连接。

项目结构

. ├── src/govee_mcp_server/ │ ├── init.py │ ├── server.py # MCP 服务器实现 │ └── cli.py # 命令行界面 ├── tests/ │ ├── test_server.py # 服务器测试（模拟 API） │ └── test_cli.py # CLI 测试（真实 API 调用） └── pyproject.toml # 项目配置

测试覆盖率

• 服务器测试覆盖：

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

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