使用说明
MCP政府
一 主控程序 让AI助手控制您的服务器 州长 智能设备。打开和关闭灯光、改变颜色、调整亮度、激活场景等等——所有这些都是通过自然对话完成的。
适用于Claude Desktop、Claude Code或任何兼容MCP的客户端。
用例
- 让你的人工智能用自然语言设置情绪——“让它感觉舒适”或“我需要明亮的光线来集中注意力”
- 用一个请求协调多个设备——“关闭除走廊外的所有设备”
- 让你的人工智能管理照明,作为更大工作流程的一部分——“我要开始一个会议,调暗办公室的灯”
- 使用自然语言查找和激活场景,而无需滚动应用程序
- 让您的AI检查设备状态并排除后端连接故障
设置
需要 Node.js 18+.
1.获取政府API密钥
打开 总督府 在手机上安装应用程序,然后转到 设置→ 关于我们→ 申请API密钥。您将通过电子邮件收到密钥。
2.配置您的MCP客户端
将服务器添加到MCP客户端的配置中。有两种方法可以做到这一点:
选项A:直接从GitHub运行(无需安装)
{
"mcpServers": {
"govee": {
"command": "npx",
"args": ["-y", "github:danjam/mcp-govee"],
"env": {
"GOVEE_API_KEY": "your-api-key-here"
}
}
}
}
选项B:克隆并在本地运行
git clone https://github.com/danjam/mcp-govee.git
cd mcp-govee
npm install
然后将MCP客户端指向本地版本:
{
"mcpServers": {
"govee": {
"command": "node",
"args": ["/path/to/mcp-govee/dist/index.js"],
"env": {
"GOVEE_API_KEY": "your-api-key-here"
}
}
}
}
替换 /path/to/mcp-govee 使用克隆项目的实际路径。
后端
服务器支持三种不同的方式与您的Govee设备通信。默认情况下,它使用 第1版,这对大多数人来说都是开箱即用的。
| 后端 | 连接方式 | 场景支持 | 备注 |
|---|---|---|---|
| 第1版 (默认) | 政府云API | 否 | 最简单的设置,适用于所有政府设备 |
| 第2版 | Govee cloud API(更新) | 是 | 场景需要;支持与v1相同的设备。 更严格的利率限制 (见下文) |
| 局域网 | 本地网络(UDP) | 否 | 最快,无需互联网,无速率限制,但仅适用于 支持局域网的设备 在同一网络上。您必须在Govee Home应用程序中为每个设备启用LAN控制(设备设置→ 局域网控制) |
[!警告] v2的速率限制要严格得多。 v1 API允许 每分钟100个请求,但v2 API仅允许 每分钟10个请求 --这是每6秒一个请求。我们建议将v1保留为默认值,仅在需要场景特征时使用v2。
要更改默认后端,请添加 GOVEE_API_BACKEND 到您的配置:
{
"mcpServers": {
"govee": {
"command": "npx",
"args": ["-y", "github:danjam/mcp-govee"],
"env": {
"GOVEE_API_KEY": "your-api-key-here",
"GOVEE_API_BACKEND": "v2"
}
}
}
}
要启用LAN后端,还需要设置 GOVEE_LAN_ENABLED:
"env": {
"GOVEE_API_KEY": "your-api-key-here",
"GOVEE_LAN_ENABLED": "true"
}
您还可以根据每个命令覆盖后端——每个工具都接受一个可选的 backend 参数(v1, v2,或 lan).这使您可以将v1用作默认值,同时在需要时仍可以访问仅限v2的功能,如场景。您不需要将v2设置为默认值来使用场景——服务器会自动将场景命令路由到v2。
你能做什么
列出设备
查看您帐户上的所有Govee设备,包括它们的ID、型号以及它们支持的命令。这是起点——所有其他命令都需要设备的ID和型号。只有添加到Govee Home应用程序的设备才会显示,并非所有设备都支持每个命令。
工具: list_devices
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
backend |
string | 否 | 覆盖默认后端(v1, v2,或 lan) |
获取设备状态
检查设备的当前状态:是否打开或关闭、亮度级别和当前颜色。
工具: get_device_state
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID(来自列表设备) |
model |
string | 是 | 设备型号(来自列表设备) |
backend |
string | 否 | 覆盖默认后端 |
设置电源
打开或关闭设备。
工具: set_power
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
state |
string | 是 | on 或 off |
backend |
string | 否 | 覆盖默认后端 |
设置亮度
调整设备的亮度级别。
工具: set_brightness
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
brightness |
integer | 是 | 亮度级别(0-100) |
backend |
string | 否 | 覆盖默认后端 |
设置颜色
使用RGB值将设备设置为特定颜色。
工具: set_color
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
r |
整数 | 是 | 红色(0-255) |
g |
整数 | 是 | 绿色(0-255) |
b |
整数 | 是 | 蓝色(0-255) |
backend |
string | 否 | 覆盖默认后端 |
设置色温
使用色温将设备设置为暖白色或冷白色。
工具: set_color_temperature
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
temperature |
integer | 是 | 色温(开尔文)(2000-9000) |
backend |
string | 否 | 覆盖默认后端 |
列出场景
列出设备可用的内置灯光场景(例如“彩虹”、“烛光”、“海洋”)。使用此选项查看可以激活哪些场景名称。 需要v2后端。
工具: list_scenes
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
列出DIY场景
列出您在Govee Home应用程序中创建的自定义场景。 需要v2后端。
工具: list_diy_scenes
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
激活场景
按名称激活内置或DIY场景。使用 列出场景 或 列出DIY场景 首先查看可用名称。 需要v2后端。
工具: activate_scene
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id |
string | 是 | 设备ID |
model |
string | 是 | 设备型号 |
scene_name |
string | Yes | 要激活的场景名称(与列表完全匹配) |
scene_type |
string | 是 | light 对于内置场景, diy 为您的自定义场景 |