Google Solar MCP Server

Un servidor MCP (Model Context Protocol) que se conecta a la Google Solar API para obtener información sobre el potencial solar de edificios basado en coordenadas geográficas.

🚀 Características

Análisis Solar Completo: Obtiene información detallada sobre el potencial solar de edificios
Datos Financieros: Calcula ahorros estimados y períodos de recuperación
Configuraciones de Paneles: Sugiere diferentes configuraciones de paneles solares
Capas de Datos: Acceso a mapas de irradiación, máscaras de edificios y datos de sombra
Validación de Coordenadas: Validación robusta de entrada de coordenadas

📋 Requisitos Previos

Google Solar API Key: Necesita una API key válida de Google Solar API
- Visite: https://developers.google.com/maps/documentation/solar
- Habilite la Solar API en Google Cloud Console
- Genere una API key
Node.js: Versión 18 o superior

⚙️ Configuración

1. Instalar Dependencias

npm install

2. Configurar API Key

Configure la variable de entorno con su API key de Google Solar:

Windows (PowerShell):

$env:GOOGLE_SOLAR_API_KEY="su_api_key_aquí"

Windows (CMD):

set GOOGLE_SOLAR_API_KEY=su_api_key_aquí

Linux/Mac:

export GOOGLE_SOLAR_API_KEY="su_api_key_aquí"

3. Configurar en Claude Desktop

Agregue la configuración del servidor MCP a su archivo claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-solar": {
      "command": "node",
      "args": ["c:\\Users\\cesar\\OneDrive\\Documentos\\MCP\\google-solar-mcp\\src\\index.js"],
      "env": {
        "GOOGLE_SOLAR_API_KEY": "su_api_key_aquí"
      }
    }
  }
}

🛠️ Herramientas Disponibles

`get_solar_insights`

Obtiene información detallada sobre el potencial solar de un edificio.

Parámetros:

latitude (number): Latitud (-90 a 90 grados)
longitude (number): Longitud (-180 a 180 grados)

Ejemplo de uso en Claude:

Obtén la información solar para las coordenadas 40.4168, -3.7038 (Madrid)

`get_solar_data_layers`

Obtiene las capas de datos solares para un área específica.

Parámetros:

latitude (number): Latitud del centro del área
longitude (number): Longitud del centro del área
radiusMeters (number, opcional): Radio en metros (por defecto: 100)

`check_solar_api_status`

Verifica el estado de la configuración de la API.

📍 Ejemplos de Coordenadas

Ciudad	Latitud	Longitud
Madrid, España	40.4168	-3.7038
Ciudad de México	19.4326	-99.1332
Bogotá, Colombia	4.7110	-74.0721
Buenos Aires, Argentina	-34.6118	-58.3960
Santiago, Chile	-33.4489	-70.6693

🔧 Ejecución Manual (Para Pruebas)

node src/index.js

📊 Información Proporcionada

El servidor proporciona:

Área del techo: Total y aprovechable para paneles
Configuraciones de paneles: Número de paneles y generación estimada
Análisis financiero: Ahorros estimados y período de recuperación
Datos de irradiación: Horas de sol anuales
Impacto ambiental: Factor de compensación de carbono
Capas de datos: Mapas de irradiación, sombras y máscaras

❗ Solución de Problemas

Error: "API Key no configurada"

Verifique que la variable de entorno GOOGLE_SOLAR_API_KEY esté configurada
Reinicie Claude Desktop después de configurar la variable

Error: "API Key inválida"

Verifique que la API key sea correcta
Asegúrese de que la Solar API esté habilitada en Google Cloud Console

Error: "No se encontraron datos"

La Google Solar API no tiene cobertura para todas las ubicaciones
Intente con coordenadas de áreas urbanas principales

Error: "Límite de solicitudes excedido"

La API tiene límites de uso
Espere un momento antes de realizar más consultas

📝 Notas

La Google Solar API tiene cobertura limitada geográfica
Los datos financieros pueden variar según la región
Las estimaciones son aproximadas y pueden diferir de instalaciones reales

🤝 Contribuciones

Si encuentra errores o tiene sugerencias de mejora, puede:

Reportar issues
Proponer mejoras
Agregar nuevas funcionalidades

📄 Licencia

Este proyecto está bajo la licencia MIT.

Google Solar MCP Server