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 应用查找你的设备 ID 和 SKU

安装方法

通过 Smithery 安装

使用 Smithery 自动安装 Govee MCP 服务器：

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

手动安装

# 使用 pip 安装
pip install .

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

使用说明

MCP 服务器

MCP 服务器提供了一些工具，用于通过 Model Context Protocol 控制 Govee 设备。

可用工具：

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

命令行界面 (CLI)

提供一个 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      # 项目配置文件

测试覆盖率

• 服务器测试：验证 MCP 服务器的功能和性能。
• CLI 测试：测试命令行工具的实际操作和输出。

通过这些测试，可以确保 Govee MCP 服务器在各种场景下的稳定性和可靠性。