简体中文文档

GeoServer MCP Server

GeoServer MCP is an MCP (Model Context Protocol) server for GeoServer. It wraps the GeoServer REST API into MCP tools for MCP-compatible clients such as Codex, Cursor, and Claude Desktop.

Overview

• Manage workspaces, stores, layers, layer groups, feature types, styles, users, and system operations.
• Expose MCP resources and tools over stdio, streamable-http, and sse.
• Support local development, uvx launch from PyPI, Docker deployment, and 1Panel deployment.

Prerequisites

Before using GeoServer MCP, you must have a GeoServer instance already deployed and running:

• A GeoServer service with REST API enabled and accessible over the network.
• Valid credentials (username and password) for the GeoServer REST API.

Quick Start

Requirements:

• Python 3.10+
• A reachable GeoServer instance with REST API enabled

Run directly from PyPI:

uvx --from open-geoserver-mcp geoserver-mcp \
  --url http://localhost:8080/geoserver \
  --user admin \
  --password geoserver

Package naming:

• PyPI package: open-geoserver-mcp
• CLI command: geoserver-mcp

Documentation

• Documentation Index
• Installation and Startup
• Client Configuration
• MCP Resources and Tools
• Docker and 1Panel Deployment
• Local Development
• Release and Versioning

Open Source Project Files

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• CHANGELOG.md
• LICENSE
• Deployment Assets

Development

uv venv --python=3.10
uv pip install -e ".[dev]"
ruff check src tests examples
mypy src/geoserver_mcp
pytest tests -q --cov=geoserver_mcp --cov-report=term-missing
python -m compileall src examples tests

License

MIT