GeoServer
A Model Context Protocol server that connects Large Language Models to the GeoServer REST API, enabling AI assistants to query and manipulate geospatial data through natural language.
What is GeoServer?
GeoServer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that connects large language models to the geoserver rest api, enabling ai assistants to query and manipulate geospatial data through natural language.
A Model Context Protocol server that connects Large Language Models to the GeoServer REST API, enabling AI assistants to query and manipulate geospatial data through natural language.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that connects Large Language
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx geoserver-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use GeoServer
GeoServer MCP Server bridges AI assistants with GeoServer's REST API, exposing over 40 tools for managing workspaces, data stores, layers, styles, feature types, and users through natural language. GeoServer is a widely-used open-source geospatial server that publishes map and feature data via OGC standards (WMS, WFS, WCS). This MCP integration lets GIS professionals and developers query spatial data, configure layer groups, generate styled maps, and administer their GeoServer instance — all without writing REST API calls manually.
Prerequisites
- Python 3.10+ installed on your system
- uv package manager (pip install uv) or Docker for running the server
- A running GeoServer instance with REST API enabled (default port 8080)
- GeoServer admin credentials (GEOSERVER_USER and GEOSERVER_PASSWORD)
- An MCP-compatible client such as Claude Desktop or Cursor
Install the geoserver-mcp package
Create a Python 3.10 virtual environment and install geoserver-mcp, or pull the pre-built Docker image.
pip install uv
uv venv --python=3.10
source .venv/bin/activate
uv pip install geoserver-mcpVerify your GeoServer connection
Confirm your GeoServer instance is reachable and the REST API is enabled by hitting the status endpoint with your credentials.
curl -u admin:geoserver http://localhost:8080/geoserver/rest/about/status.jsonTest the server binary
Run geoserver-mcp directly to verify it starts and connects to your GeoServer instance.
geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserverConfigure Claude Desktop
Add the server to your Claude Desktop MCP configuration, pointing to the venv binary and providing GeoServer connection details.
{
"mcpServers": {
"geoserver-mcp": {
"command": "/path/to/.venv/bin/geoserver-mcp",
"args": [
"--url", "http://localhost:8080/geoserver",
"--user", "admin",
"--password", "geoserver"
]
}
}
}Restart Claude Desktop and test
Restart Claude Desktop and ask it to list GeoServer workspaces. A successful response confirms the server is connected and authenticated.
GeoServer Examples
Client configuration
Claude Desktop configuration connecting to a local GeoServer instance.
{
"mcpServers": {
"geoserver-mcp": {
"command": "/Users/you/.venv/bin/geoserver-mcp",
"args": [
"--url", "http://localhost:8080/geoserver",
"--user", "admin",
"--password", "geoserver"
]
}
}
}Prompts to try
Once connected, use these prompts to explore and manage GeoServer data.
- "List all workspaces and data stores in my GeoServer instance"
- "Show me all layers available in the 'topp' workspace"
- "Query features from the topp:states layer where PERSONS > 10000000"
- "Generate a map image of the United States using the topp:states layer"
- "Create a new workspace called 'myproject' and tell me how to add a shapefile data store to it"Troubleshooting GeoServer
Connection refused or timeout when connecting to GeoServer
Verify GeoServer is running on the correct port: curl http://localhost:8080/geoserver/web/. Ensure the --url argument does not have a trailing slash. If GeoServer runs on a different host or port, update GEOSERVER_URL accordingly.
Authentication fails with 401 even with correct credentials
GeoServer REST API uses HTTP Basic Auth. Ensure the user has REST API admin privileges — not just layer-level access. In GeoServer admin UI, go to Security → Users and verify the account has ROLE_ADMINISTRATOR or ROLE_AUTHENTICATED.
geoserver-mcp binary not found after installation
The binary is installed in the virtual environment's bin directory. Activate the venv first (source .venv/bin/activate) or use the absolute path to the binary in your Claude Desktop config, e.g. /Users/you/geoserver-venv/bin/geoserver-mcp.
Frequently Asked Questions about GeoServer
What is GeoServer?
GeoServer is a Model Context Protocol (MCP) server that model context protocol server that connects large language models to the geoserver rest api, enabling ai assistants to query and manipulate geospatial data through natural language. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install GeoServer?
Follow the installation instructions on the GeoServer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with GeoServer?
GeoServer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is GeoServer free to use?
Yes, GeoServer is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
GeoServer Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to GeoServer? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up GeoServer in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use GeoServer?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.