Servidor MCP de MeteoControl

Un servidor del Protocolo de Contexto de Modelo (MCP) para la API v2 de MeteoControl VCOM. Esta extensión le permite monitorizar paneles solares, recuperar datos de producción de energía y realizar comprobaciones del estado del sistema utilizando lenguaje natural a través de la CLI de Gemini.

Características

• Descubrimiento de sistemas: Enumere todos los sistemas solares asociados a su cuenta.

• Monitorización de energía: Recupere datos históricos de producción de energía (Wh/kWh/MWh).

• Información de activos: Obtenga detalles técnicos sobre paneles, inversores y capacidad del sitio.

• Potencia en tiempo real: Compruebe la potencia de salida de CA instantánea.

• Soporte de transporte múltiple: Ejecute localmente a través de Stdio o aloje remotamente a través de SSE.

• Multi-inquilino (BYOC): Soporte para "Traiga sus propias credenciales" (Bring Your Own Credentials) en un entorno compartido.

Instalación

A través de la CLI de Gemini (Recomendado)

Para instalar la extensión directamente desde GitHub:

gemini extensions add https://github.com/your-org/meteocontrol-mcp

Instalación manual

1. Clone el repositorio:

   git clone https://github.com/your-org/meteocontrol-mcp.git
   cd meteocontrol-mcp

2. Instale las dependencias y compile:

   npm install
   npm run build

Uso

Una vez instalado, puede preguntar a Gemini sobre sus sistemas solares:

• "Enumera mis sistemas solares."

• "¿Cuál es la producción de energía del sistema [systemKey] en las últimas 24 horas?"

• "Muéstrame los detalles técnicos de INV1 en el sistema [systemKey]."

Uso multi-inquilino (BYOC)

Si está utilizando un servidor MCP compartido, puede proporcionar sus propias credenciales directamente en sus prompts o configurarlas localmente. Las herramientas aceptan argumentos opcionales apiKey, user y password.

Comandos preconfigurados

• /health [systemKey]: Realice una comprobación completa del estado del sitio.

• /yield [systemKey]: Recupere y resuma los datos de producción de energía.

Despliegue y alojamiento

El servidor admite múltiples modos de funcionamiento:

1. Modo local (Stdio)

Este es el modo predeterminado utilizado por la CLI de Gemini.

• Comando: node dist/index.js

• Configuración: Definido en gemini-extension.json usando command y args.

2. Modo remoto (SSE)

Utilice este modo para alojar el servidor MCP en un servidor central para múltiples usuarios.

Seguridad: Generación de un token de acceso

El modo remoto requiere un MCP_SERVER_TOKEN obligatorio por seguridad. Puede generar un token seguro usando:

openssl rand -base64 32

Configuración del servidor

• Variables de entorno:

  • MCP_TRANSPORT=sse

  • MCP_SERVER_TOKEN=su_token_generado (Requerido)

  • PORT=3000 (opcional, el valor predeterminado es 3000)

• Comando de ejecución:

  MCP_TRANSPORT=sse MCP_SERVER_TOKEN=your_token node dist/index.js

3. Modo Docker

Puede ejecutar el servidor como un contenedor para un despliegue sencillo.

Para el modo Stdio (uso de CLI):

docker run -i --rm \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Para el modo SSE (uso alojado):

docker run -d \
  -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SERVER_TOKEN=your_token \
  -e METEOCONTROL_API_KEY=your_key \
  -e METEOCONTROL_USER=your_user \
  -e METEOCONTROL_PASSWORD=your_password \
  ghcr.io/your-org/meteocontrol-mcp:latest

Configuración del cliente (para SSE)

En su archivo local .gemini/settings.json, añada la url y la cabecera Authorization:

{
  "mcpServers": {
    "meteocontrol": {
      "url": "https://your-mcp-server.com/sse",
      "headers": {
        "Authorization": "Bearer your_generated_token"
      }
    }
  }
}

Configuración

Las siguientes variables de entorno son necesarias para que el servidor se comunique con MeteoControl (a menos que se proporcionen credenciales por solicitud):

• METEOCONTROL_API_KEY: Su clave de API de VCOM.

• METEOCONTROL_USER: Su nombre de usuario de VCOM (correo electrónico).

• METEOCONTROL_PASSWORD: Su contraseña de VCOM.

Licencia

Licencia Apache 2.0