Google Home MCP Server

基本能力

产品定位

Google Home MCP Server 是一个用于控制 Google Home 智能插座的 MCP 服务器实现，通过 Smart Home API 提供设备管理和控制功能。

核心功能

• 列出所有可用的智能插座及其状态
• 控制智能插座（开关）
• 获取特定智能插座的实时状态
• 自动设备状态刷新
• 通过 OAuth2 认证与 Smart Home 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 Client ID 和 Secret
• 设备未找到：确保设备 ID 正确且在可用设备列表中
• API 错误：检查 Smart Home API 是否已启用并配置正确

使用教程

使用依赖

1. 确保已安装 Node.js 18 或更高版本
2. 创建一个 Google Cloud 项目并启用 Smart Home API
3. 在 Actions on Google Console 中创建一个 Smart Home Action 项目
4. 配置 OAuth 2.0 客户端凭据

安装教程

1. 克隆项目仓库
2. 安装依赖：

pnpm install

1. 配置服务器：
2. 复制 config.json.example 到 config.json
3. 填写 OAuth Client ID 和 Secret
4. 构建服务器：

pnpm build

1. 启动服务器：

pnpm start

调试方式

1. 开发模式启动：

pnpm dev

1. 运行测试：

pnpm test

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

许可证

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