智能设备控制服务

通过AI助手控制Govee智能设备的MCP服务器,支持灯光开关、颜色调整、亮度调节和场景激活等功能。

  • by danjam
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 danjam/mcp-govee

使用说明

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 为您的自定义场景

许可证

麻省理工学院