通过 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要获取这些值：
从 Govee 开发者门户获取您的 API 密钥
使用 Govee Home 应用查找您的设备 ID 和 SKU
Related MCP server: ESP RainMaker MCP Server
要通过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) 控制 Govee 设备的工具。它可以与 Cline 或其他 MCP 客户端一起使用。
可用工具：
turn_on_off ：打开或关闭 LED
set_color ：使用 RGB 值设置 LED 颜色
set_brightness ：设置 LED 亮度级别
提供 CLI 用于直接控制 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 测试会对您的 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 设备，从而执行真实世界的集成测试。
This server cannot be deployed
Tailscale device, route, DNS, key, user, and ACL management over MCP and CLI.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
