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 开发者门户获取你的 API 密钥
2. 使用 Govee Home app 找到你的设备 ID 和 SKU

安装

通过 Smithery 安装

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

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

手动安装

# 使用 pip 安装
pip install .

# 用于开发（包含测试依赖）
pip install -e ".[test]"

使用

MCP 服务器

MCP 服务器提供通过模型上下文协议控制 Govee 设备的工具。 它可以与 Cline 或其他 MCP 客户端一起使用。

可用工具：

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

命令行界面

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

# 打开/关闭设备
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 获取完整的命令文档。

开发

运行测试

要运行测试套件：

# 安装测试依赖
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 设备，从而执行真实世界的集成测试。