Servidor MCP de Google Home

Una implementación de servidor MCP para controlar los enchufes inteligentes de Google Home a través de la API Smart Home.

Características

Enumere todos los enchufes inteligentes disponibles y sus estados
Controlar enchufes inteligentes (encender/apagar)
Obtenga el estado en tiempo real de enchufes inteligentes específicos
Actualización automática del estado del dispositivo
Autenticación OAuth2 con API de Smart Home

Prerrequisitos

Proyecto de Google Cloud con API de Smart Home habilitada
Acciones en el proyecto Google Smart Home Action
Credenciales de cliente OAuth 2.0 para Smart Home Action
Node.js 18 o superior
Acceso a los enchufes inteligentes de Google Home

Configuración

Crear una acción de casa inteligente:
- Ir a Acciones en Google Console
- Crear un nuevo proyecto
- Elija "Casa inteligente" como tipo de proyecto
- Configurar la vinculación de cuentas:
  - ID de cliente de OAuth
  - Secreto de cliente OAuth
  - URL de autorización
  - URL del token
Configurar OAuth 2.0:
- Configurar los puntos finales del servidor OAuth
- Configurar el flujo de autenticación de usuarios
- Implementar la generación/validación de tokens
Instalar dependencias:

pnpm install

Configurar el servidor:
- Copiar config.json.example a config.json
- Complete su:
  - ID de cliente de OAuth
  - Secreto de cliente OAuth
Construir el servidor:

pnpm build

Iniciar el servidor:

pnpm start

Herramientas disponibles

1. Lista de enchufes inteligentes

{
  name: "list_smart_plugs",
  description: "List all available smart plugs and their current states",
  response: Array<{
    id: string;
    name: string;
    state: {
      on: boolean;
      online: boolean;
    }
  }>
}

2. Control del enchufe inteligente

{
  name: "control_smart_plug",
  description: "Turn a smart plug on or off",
  parameters: {
    deviceId: string;  // Device ID from list_smart_plugs
    state: boolean;    // true for on, false for off
  },
  response: {
    success: boolean;
    device: {
      id: string;
      name: string;
      state: {
        on: boolean;
        online: boolean;
      }
    }
  }
}

3. Obtener el estado del enchufe inteligente

{
  name: "get_smart_plug_state",
  description: "Get the current state of a specific smart plug",
  parameters: {
    deviceId: string;  // Device ID from list_smart_plugs
  },
  response: {
    id: string;
    name: string;
    state: {
      on: boolean;
      online: boolean;
    }
  }
}

Detalles de la API

El servidor implementa las intenciones de la API de Smart Home:

Intención de sincronización
- Se llama cuando los usuarios vinculan su cuenta
- Informa sobre dispositivos y capacidades disponibles
- Maneja el descubrimiento de dispositivos
Intención de CONSULTA
- Informa sobre el estado actual de los dispositivos
- Maneja consultas de estado del Asistente de Google
- Devuelve el estado en línea/fuera de línea
Intención EJECUTAR
- Maneja comandos de control del dispositivo
- Ejecuta operaciones de encendido y apagado
- Los informes indican el éxito o el fracaso del comando

Manejo de errores

El servidor implementa un manejo integral de errores con códigos de error específicos:

CONFIG_ERROR : Errores de carga o validación de configuración
API_ERROR : Errores de la API de Smart Home
DEVICE_NOT_FOUND : ID del dispositivo no encontrado entre los dispositivos disponibles
COMMAND_ERROR : Error al ejecutar el comando del dispositivo

Cada error incluye:

Mensaje de error
Código de error
Información detallada del error cuando esté disponible

Seguridad

Flujo de autenticación de OAuth 2.0
Manejo seguro de tokens
Validación de solicitud
Autorización de comando
Comunicación HTTPS
Sanitización de entrada

Desarrollo

Iniciar en modo de desarrollo:

pnpm dev

Ejecutar pruebas:

pnpm test

Registros de depuración:
- Se registran todas las llamadas a la API
- Se capturan los detalles del error
- Se rastrean los cambios de estado del dispositivo

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

servidor ghome-mcp

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite a los usuarios controlar los enchufes inteligentes de Google Home mediante la API Smart Home con autenticación OAuth2, ofreciendo operaciones de control y gestión del estado del dispositivo en tiempo real.

Related Resources

Reddit Discussion about this server

Related MCP Servers

homeassistant-mcp
tevonsb
-
security
A
license
-
quality
Access Home Assistant data and control devices (lights, switches, thermostats, etc).
Last updated -
6
123
TypeScript
Apache 2.0
Google Workspace MCP Server
aaronsb
-
security
A
license
-
quality
Provides authenticated access to Google Workspace APIs with a focus on Gmail operations and planned Calendar support, featuring secure OAuth authentication and multi-account management with detailed error handling.
Last updated -
73
TypeScript
MIT License
Gmail MCP Server
Quantum-369
-
security
A
license
-
quality
Enables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.
Last updated -
8
Python
Apache 2.0
MCP G Suite Integration
alBERT-launcher
-
security
A
license
-
quality
Integration server that enables interaction with Google services including Gmail and Calendar, allowing users to manage emails, draft responses, and schedule events across multiple Google accounts.
Last updated -
Python
MIT License

View all related MCP servers

Google Home MCP Server