Google Home MCP Server

基本能力

产品定位

ghome-mcp-server 是一个用于控制 Google Home 智能插座的 MCP 服务器，通过智能家居 API 实现设备管理和控制。

核心功能

• 列出所有可用的智能插座及其状态
• 控制智能插座（开关）
• 获取特定智能插座的实时状态
• 自动设备状态刷新
• 通过 OAuth2 认证与智能家居 API 交互

适用场景

• 家庭自动化控制
• 远程设备管理
• 智能家居系统集成

工具列表

1. List Smart Plugs
2. 功能：列出所有可用的智能插座及其当前状态

3. 响应：包含设备 ID、名称和状态（开关状态、在线状态）的数组

4. Control Smart Plug

5. 功能：控制智能插座的开关状态
6. 参数：设备 ID 和目标状态（开/关）

7. 响应：操作是否成功及设备最新状态

8. Get Smart Plug State

9. 功能：获取特定智能插座的当前状态
10. 参数：设备 ID
11. 响应：设备 ID、名称和状态（开关状态、在线状态）

常见问题解答

• 配置错误：检查 config.json 文件是否正确填写 OAuth 客户端 ID 和密钥
• API 错误：确保智能家居 API 已启用且 OAuth 认证流程正确
• 设备未找到：确认设备 ID 是否正确且在可用设备列表中
• 命令错误：检查设备是否在线且支持该操作

使用教程

使用依赖

1. 确保已安装 Node.js 18 或更高版本
2. 创建一个 Google Cloud 项目并启用智能家居 API
3. 在 Actions on Google 控制台中创建一个智能家居项目
4. 配置 OAuth 2.0 客户端凭据

安装教程

1. 克隆项目并安装依赖

pnpm install

1. 复制配置文件并填写 OAuth 客户端 ID 和密钥

cp config.json.example config.json

1. 构建服务器

pnpm build

1. 启动服务器

pnpm start

调试方式

1. 开发模式启动

pnpm dev

1. 运行测试

pnpm test

1. 查看调试日志
2. API 调用日志
3. 错误详细信息
4. 设备状态变更记录

许可证

该项目遵循 MIT 开源许可条款。