Google Home智能插座控制服务

Google Home MCP Server 是一个用于通过Smart Home API控制Google Home智能插座的服务。它提供了列出所有可用的智能插座及其状态、控制智能插座(开/关)、获取特定智能插座的实时状态等功能。适用于需要远程控制和管理Google Home智能插座的场景。

  • by jmagar
  • 更新于
在 GitHub 查看 jmagar/ghome-mcp-server

使用说明

基本能力

产品定位

Google Home MCP Server 是一个用于通过Smart Home API控制Google Home智能插座的服务。

核心功能

  • 列出所有可用的智能插座及其状态
  • 控制智能插座(开/关)
  • 获取特定智能插座的实时状态
  • 自动刷新设备状态
  • 使用Smart Home API进行OAuth2认证

适用场景

  • 需要远程控制和管理Google Home智能插座的场景
  • 智能家居自动化
  • 家庭能源管理

工具列表

  1. 列出智能插座
    • 列出所有可用的智能插座及其当前状态
  2. 控制智能插座
    • 打开或关闭智能插座
  3. 获取智能插座状态
    • 获取特定智能插座的当前状态

使用教程

使用依赖

  1. 启用了Smart Home API的Google Cloud项目
  2. Actions on Google Smart Home Action项目
  3. Smart Home Action的OAuth 2.0客户端凭据
  4. Node.js 18或更高版本
  5. 访问Google Home智能插座的权限

安装教程

  1. 创建Smart Home Action:

    • 访问Actions on Google Console
    • 创建新项目
    • 选择"Smart Home"作为项目类型
    • 配置账户链接:
      • OAuth Client ID
      • OAuth Client Secret
      • Authorization URL
      • Token URL
  2. 设置OAuth 2.0:

    • 配置OAuth服务器端点
    • 设置用户认证流程
    • 实现令牌生成/验证
  3. 安装依赖:

pnpm install
  1. 配置服务器:

    • 复制config.json.example到config.json
    • 填写OAuth Client ID和OAuth Client Secret
  2. 构建服务器:

pnpm build
  1. 启动服务器:
pnpm start

调试方式

  1. 开发模式启动:
pnpm dev
  1. 运行测试:
pnpm test
  1. 调试日志:
    • 所有API调用都会被记录
    • 错误详情会被捕获
    • 设备状态变化会被跟踪