Provides access to the Generalitat Valenciana (GVA) ArcGIS REST API for querying land activity data, including layer metadata retrieval, feature queries with SQL filters, record counting, and GeoJSON export capabilities.
MCP4GVA - MCP Server para GVA GIS
Servidor MCP (Model Context Protocol) mínimo para acceder a la API de GVA GIS (Generalitat Valenciana) - Servicio de Suelo de Actividades.
Endpoint: https://gvagis.icv.gva.es/server/rest/services/Hosted/Suelo_actividades/FeatureServer/2
¿Qué es esto?
Un servidor MCP que expone la API de ArcGIS REST de la Generalitat Valenciana para que Claude Desktop (y otras aplicaciones MCP) puedan consultar datos de suelo de actividades directamente.
Instalación
1. Instalar el paquete
2. Configurar Claude Desktop
Edita el archivo de configuración de Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Añade la configuración del servidor MCP:
O si instalaste en modo desarrollo, puedes usar la ruta absoluta:
3. Reiniciar Claude Desktop
Reinicia Claude Desktop para que cargue el nuevo servidor MCP.
Herramientas Disponibles
El servidor expone 4 herramientas que Claude puede usar:
1. gva_layer_info
Obtiene metadatos de la capa (campos, tipo de geometría, sistema de referencia, extensión).
Parámetros: Ninguno
Ejemplo en Claude:
2. gva_query
Consulta features de la capa con filtros SQL.
Parámetros:
where(string, default: "1=1"): Cláusula SQL WHEREout_fields(string, default: ""): Campos a devolver (separados por coma o "")return_geometry(boolean, default: true): Devolver geometríaresult_record_count(integer, default: 10): Máximo de registrosresult_offset(integer, default: 0): Offset para paginación
Ejemplo en Claude:
3. gva_count
Cuenta features que cumplen una condición.
Parámetros:
where(string, default: "1=1"): Cláusula SQL WHERE
Ejemplo en Claude:
4. gva_export_geojson
Exporta features a formato GeoJSON.
Parámetros:
where(string, default: "1=1"): Filtro SQLout_fields(string, default: "*"): Campos a incluirresult_record_count(integer, default: 100): Máximo de features
Ejemplo en Claude:
Ejemplos de Uso en Claude Desktop
Una vez configurado, puedes pedirle a Claude cosas como:
Explorar la capa:
¿Qué información tiene la capa de GVA GIS?Consultar datos:
Obtén 10 registros de la capa de suelo de actividadesFiltrar por campo:
Muéstrame todos los registros del municipio de ValenciaContar registros:
¿Cuántos registros hay en total en la capa?Exportar datos:
Exporta a GeoJSON los primeros 50 registros
Estructura del Proyecto
Uso Standalone (sin MCP)
También incluye un cliente Python que puedes usar directamente:
Ver examples.py para más ejemplos.
Parámetros de Consulta SQL
Operadores básicos
Operadores lógicos
Debugging
Para ver los logs del servidor MCP:
Los logs aparecerán en la salida estándar.
Limitaciones
La API puede tener restricciones geográficas (IP)
Timeout de 30 segundos por petición
Límite de registros por consulta (usar paginación para grandes datasets)
Solución de Problemas
El servidor no aparece en Claude Desktop
Verifica que el archivo de configuración esté en la ubicación correcta
Revisa que la sintaxis JSON sea válida
Reinicia Claude Desktop completamente
Verifica que
mcpesté instalado:pip show mcp
Error 403 / Access Denied
La API tiene restricciones geográficas. Asegúrate de que tu IP tiene acceso (normalmente funciona desde España).
El comando no funciona
Verifica la instalación:
Recursos
Licencia
Este proyecto es código abierto. Los datos pertenecen a la Generalitat Valenciana.
This server cannot be installed
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.
Enables access to GVA GIS (Generalitat Valenciana) geographic data through ArcGIS REST API, allowing queries, filtering, and exporting of land activity information in the Valencian Community.