open-geoserver-mcp 1.0.4

A GeoServer MCP server implementation that enhances LLM capabilities with geospatial data and mapping services via GeoServer REST API

简体中文文档

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