MeteoControl MCP Server
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.
Related MCP server: Tigo Energy MCP Server
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-mcpInstalación manual
Clone el repositorio:
git clone https://github.com/your-org/meteocontrol-mcp.git cd meteocontrol-mcpInstale 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.jsConfiguración: Definido en
gemini-extension.jsonusandocommandyargs.
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 32Configuración del servidor
Variables de entorno:
MCP_TRANSPORT=sseMCP_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:latestPara 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:latestConfiguració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
Available Tools
4 toolsget_alertsD
Inputs: systemKey (required), apiKey, user, password.
get_asset_infoD
Inputs: systemKey (required), apiKey, user, password.
get_energy_dataD
Inputs: systemKey (required), from (required), to (required), apiKey, +2 more.
list_systemsD
Inputs: apiKey, user, password.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: get_alerts retrieves alerts, get_asset_info provides asset details, get_energy_data handles energy data, and list_systems lists systems. There is no overlap or ambiguity between these functions, making it easy for an agent to select the correct tool.
All tool names follow a consistent verb_noun pattern with 'get_' or 'list_' prefixes, using snake_case uniformly. This predictable naming scheme enhances readability and reduces confusion for agents.
With 4 tools, the count is reasonable for a server focused on meteorological control, but it feels slightly thin for comprehensive coverage. It includes core functions like alerts, assets, energy data, and systems, but might benefit from additional tools for broader operations.
The tools cover key read operations (get and list), but there are notable gaps in CRUD coverage, such as missing create, update, or delete functions for alerts, assets, energy data, or systems. This could limit agents in performing full lifecycle management tasks.
Maintenance
Related MCP Connectors
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
MCP server for Uptrack uptime monitoring. Manage monitors and incidents from AI agents.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to look up solar permitting authorities, estimate solar production via PVWatts, and retrieve irradiance data. It streamlines the creation of solar-aware workflows by integrating industry-standard APIs like NREL.MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides comprehensive access to Tigo Energy solar system data and analytics. It enables AI assistants to interact with your Tigo solar monitoring system to retrieve production data, performance metrics, system health information, and maintenance insights.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for EG4 solar inverters, enabling real-time monitoring, performance analysis, battery health, alerts, maintenance insights, and historical data via natural language.MIT
- AlicenseAqualityCmaintenanceA lean Model Context Protocol (MCP) server that gives AI assistants like Claude structured access to a SolarEdge PV installation via the official SolarEdge Monitoring API.4MIT