Geoservercloud MCP

🚀 GeoServer MCP Server

A Model Context Protocol (MCP) server that enables natural - language interaction with GeoServer REST API through AI assistants.

🚀 Quick Start

This MCP server exposes the REST API functionality of GeoServer for natural language interaction. AI assistants like Claude, VS Code Copilot, and other MCP - compatible clients can use it to interact with GeoServer.

✨ Features

• Wraps the python - geoservercloud library, exposing over 80 GeoServer operations as MCP tools.
• Allows AI assistants to manage GeoServer workspaces, datastores, layers, styles, etc. via natural language commands.

Example Interactions

Once connected, you can ask your AI assistant things like:

• "List all workspaces in GeoServer"
• "Create a new workspace called 'test_data'"
• "What layers are available in the 'topp' workspace?"
• "Create a PostGIS datastore connection"

📦 Installation

From PyPI

pip install geoservercloud - mcp

Or use uvx to run without installing (requires uv):

# Install uv first (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the MCP server
uvx geoservercloud - mcp

From MCP Registry

This server is published to the MCP Registry as:

io.github.ronitjadhav/geoservercloud - mcp

💻 Usage Examples

Connecting to AI Clients

VS Code / Cursor

Add to your MCP configuration (.vscode/mcp.json):

{
  "servers": {
    "geoserver": {
      "command": "uvx",
      "args": ["geoservercloud - mcp"],
      "env": {
        "GEOSERVER_URL": "http://localhost:8080/geoserver",
        "GEOSERVER_USER": "admin",
        "GEOSERVER_PASSWORD": "geoserver"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "geoserver": {
      "command": "uvx",
      "args": ["geoservercloud - mcp"],
      "env": {
        "GEOSERVER_URL": "http://localhost:8080/geoserver",
        "GEOSERVER_USER": "admin",
        "GEOSERVER_PASSWORD": "geoserver"
      }
    }
  }
}

Restart Claude Desktop after saving the configuration.

Python Library

This MCP server is built on the python - geoservercloud library. For programmatic access without MCP, see the library documentation.

from geoservercloud import GeoServerCloud

geoserver = GeoServerCloud(
    url="http://localhost:8080/geoserver",
    user="admin",
    password="geoserver",
)
geoserver.create_workspace("my_workspace")

Full documentation: <https://camptocamp.github.io/python - geoservercloud/>

📚 Documentation

Environment Variables

🔧 Technical Details

For local development, testing, and publishing, see the Developer Guide.