Servidor MCP de GeoServer

Una implementación de servidor de Protocolo de contexto de modelo (MCP) que conecta modelos de lenguaje grandes (LLM) a la API REST de GeoServer, lo que permite que los asistentes de IA interactúen con datos y servicios geoespaciales.

🚀 Características

🔍 Consultar y manipular espacios de trabajo, capas y estilos de GeoServer
🗺️ Ejecutar consultas espaciales en datos vectoriales
🎨 Generar visualizaciones de mapas
🌐 Acceda a servicios web compatibles con OGC (WMS, WFS)

📋 Requisitos previos

Python 3.10+
Ejecución de una instancia de GeoServer con la API REST habilitada
Cliente compatible con MCP (como Claude Desktop)
paquete geoserver-rest

🛠️ Instalación

Instalar el paquete:

pip install -e .

Configurar la conexión GeoServer:

Linux/Mac:

export GEOSERVER_URL="http://localhost:8080/geoserver"
export GEOSERVER_USER="admin"
export GEOSERVER_PASSWORD="geoserver"

Windows PowerShell:

$env:GEOSERVER_URL="http://localhost:8080/geoserver"
$env:GEOSERVER_USER="admin"
$env:GEOSERVER_PASSWORD="geoserver"

Iniciar el servidor:

geoserver-mcp-server

🔧 Configuración

Argumentos de la línea de comandos

geoserver-mcp-server --url http://localhost:8080/geoserver --user admin --password geoserver --debug

Integración de clientes MCP

Escritorio de Claude

Editar claude_desktop_config.json :

"mcpServers": {
  "geoserver-mcp-server": {
    "command": "geoserver-mcp-server",
    "args": [
      "--url", "http://localhost:8080/geoserver",
      "--user", "admin",
      "--password", "geoserver"
    ]
  }
}

Cursor

Crear .cursor/mcp.json :

{
  "mcpServers": {
    "geoserver-mcp-server": {
      "command": "geoserver-mcp-server",
      "args": [
        "--url",
        "http://localhost:8080/geoserver",
        "--user",
        "admin",
        "--password",
        "geoserver"
      ]
    }
  }
}

🛠️ Herramientas disponibles

Gestión de catálogos

list_workspaces - Obtener espacios de trabajo disponibles
create_workspace - Crea un nuevo espacio de trabajo
get_layer_info - Obtener metadatos detallados de la capa
list_layers - Lista de capas en un espacio de trabajo
create_layer - Crea una nueva capa
delete_resource - Eliminar recursos

Operaciones de datos

query_features : ejecuta consultas CQL en datos vectoriales

Visualización

generate_map - Crea imágenes de mapas con estilo
create_style - Define nuevos estilos SLD

📚 Ejemplo de uso

Lista de espacios de trabajo

Tool: list_workspaces
Parameters: {}
Response: ["default", "demo", "topp", "tiger", "sf"]

Así es como aparecen los espacios de trabajo en el cliente MCP:

La captura de pantalla muestra los espacios de trabajo disponibles en la instancia de GeoServer, incluyendo: mahdi, demo-workspace, cite, tiger, nurc, sde, it.geosolutions, topp y sf. Estos espacios de trabajo sirven como contenedores para organizar los recursos de GeoServer.

Obtener información de la capa

Tool: get_layer_info
Parameters: {
  "workspace": "topp",
  "layer": "states"
}

Características de consulta

Tool: query_features
Parameters: {
  "workspace": "topp",
  "layer": "states",
  "filter": "PERSONS > 10000000",
  "properties": ["STATE_NAME", "PERSONS"]
}

Generar mapa

Tool: generate_map
Parameters: {
  "layers": ["topp:states"],
  "styles": ["population"],
  "bbox": [-124.73, 24.96, -66.97, 49.37],
  "width": 800,
  "height": 600,
  "format": "png"
}

🔮 Funciones planificadas

Gestión de cobertura y datos ráster
Seguridad y control de acceso
Capacidades de estilo avanzadas
Operaciones de procesamiento de WPS
Integración de GeoWebCache

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

GeoServer MCP Server