GeoServer MCP Server

@mahdin75

About GeoServer MCP Server

A Model Context Protocol (MCP) server implementation that connects LLMs to the GeoServer REST API

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@mahdin75/geoserver-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is GeoServer MCP Server?

GeoServer MCP Server is a Model Context Protocol (MCP) server implementation that connects large language models (LLMs) to the GeoServer REST API. It enables AI assistants to interact with geospatial data and services, making it suitable for developers, GIS professionals, and anyone integrating GeoServer with MCP-compatible clients.

How to use GeoServer MCP Server?

Install via Docker (docker pull mahdin75/geoserver-mcp), pip (uv pip install geoserver-mcp), or Smithery (npx -y @smithery/cli install @mahdin75/geoserver-mcp --client claude). Configure the GeoServer connection using environment variables (GEOSERVER_URL, GEOSERVER_USER, GEOSERVER_PASSWORD) or CLI arguments (--url, --user, --password). Optionally set a file‑storage root with --storage. Then integrate with an MCP client (e.g., Claude Desktop, Cursor) by editing its configuration file.

Key features of GeoServer MCP Server

Query and manipulate GeoServer workspaces, layers, and styles
Execute spatial queries on vector data
Generate map visualizations
Access OGC-compliant web services (WMS, WFS)
Easy integration with MCP-compatible clients
Supports Docker, pip, and development installations

Use cases of GeoServer MCP Server

Managing GeoServer workspaces, datastores, and layers via natural language
Running spatial queries and retrieving feature information
Generating and styling maps using GeoServer’s WMS/WFS services
Automating geospatial workflows with AI assistants in tools like Claude Desktop or Cursor

FAQ from GeoServer MCP Server

What are the prerequisites for using GeoServer MCP Server?

Python 3.10 or higher, a running GeoServer instance with the REST API enabled, an MCP-compatible client (e.g., Claude Desktop or Cursor), and an internet connection for package installation.

How do I configure the GeoServer connection?

Set the environment variables GEOSERVER_URL, GEOSERVER_USER, and GEOSERVER_PASSWORD, or pass them as CLI arguments (--url, --user, --password). The default values are http://localhost:8080/geoserver, admin, and geoserver.

Can I run GeoServer MCP Server in Docker?

Yes. Pull the image with docker pull mahdin75/geoserver-mcp and run it with the required environment variables. Mount a host directory as a Docker volume when using the --storage flag for file operations.

How does file storage work with the `--storage` flag?

The --storage flag sets a base directory for all file read/write operations (e.g., uploading shapefiles or exporting results). Relative paths are resolved against this root; absolute paths are used as‑is. When running in Docker, ensure the directory is mounted as a volume.

Which MCP clients are supported?

GeoServer MCP Server works with any MCP-compatible client. The README provides configuration examples for Claude Desktop and Cursor.

Frequently asked questions

What are the prerequisites for using GeoServer MCP Server?

Python 3.10 or higher, a running GeoServer instance with the REST API enabled, an MCP-compatible client (e.g., Claude Desktop or Cursor), and an internet connection for package installation.

How do I configure the GeoServer connection?

Set the environment variables `GEOSERVER_URL`, `GEOSERVER_USER`, and `GEOSERVER_PASSWORD`, or pass them as CLI arguments (`--url`, `--user`, `--password`). The default values are `http://localhost:8080/geoserver`, `admin`, and `geoserver`.

Can I run GeoServer MCP Server in Docker?

Yes. Pull the image with `docker pull mahdin75/geoserver-mcp` and run it with the required environment variables. Mount a host directory as a Docker volume when using the `--storage` flag for file operations.

How does file storage work with the `--storage` flag?

The `--storage` flag sets a base directory for all file read/write operations (e.g., uploading shapefiles or exporting results). Relative paths are resolved against this root; absolute paths are used as‑is. When running in Docker, ensure the directory is mounted as a volume.

Which MCP clients are supported?

GeoServer MCP Server works with any MCP-compatible client. The README provides configuration examples for Claude Desktop and Cursor.

Comments

Basic information

More Other MCP servers

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K