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要获取这些值:
从 Govee 开发者门户获取您的 API 密钥
使用 Govee Home 应用查找您的设备 ID 和 SKU
Related MCP server: ESP RainMaker MCP Server
安装
通过 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 服务器提供通过模型上下文协议 (MCP) 控制 Govee 设备的工具。它可以与 Cline 或其他 MCP 客户端一起使用。
可用工具:
turn_on_off:打开或关闭 LEDset_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 installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables control and monitoring of Home Assistant smart home devices through MCP protocol. Automatically manages authentication tokens and provides simplified tools for device discovery, switch control, and light brightness adjustment.MIT
- AlicenseAqualityFmaintenanceEnables MCP-compatible clients to interact with ESP RainMaker devices for node management, parameter control, scheduling, and group management via the official CLI.1317Apache 2.0
- AlicenseAqualityDmaintenanceEnables AI assistants to control Govee smart devices, including lights, via natural language. Supports turning on/off, changing colors, adjusting brightness, and activating scenes through the Govee API or local network.91MIT
- AlicenseAqualityCmaintenanceMCP server for controlling Elgato Key Lights. Enables turning lights on/off, adjusting brightness and color temperature, applying presets, and triggering effects via Claude.13Apache 2.0
Related MCP Connectors
Tailscale device, route, DNS, key, user, and ACL management over MCP and CLI.
ClickUp MCP — wraps the ClickUp REST API v2 (BYO API key)
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mathd/govee_mcp_server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server