Geoserver MCP Server

🚀 GeoServer MCP Server

Welcome to the GeoServer MCP Server! This is an open-source tool based on the Model Context Protocol (MCP) for interacting with the GeoServer REST API. With this project, you can easily operate on vector data, styles, workspaces, and layers.

🚀 Quick Start

1. Install Dependencies

pip install geoserver-mcp requests

2. Example Usage

Here is a simple client example:

from geoserver_mcp.client import MCPClient

client = MCPClient(base_url="http://localhost:8080/geoserver/rest", username="admin", password="geoserver")

# Get the list of workspaces
print(client.list_workspaces())

# Create a new workspace
client.create_workspace("my_new_workspace")

# Delete a resource
client.delete_resource(workspace="topp", layer="states")

✨ Features

Tool Categories

Workspace and Layer Management

Data Operations

Visualization

Example Usage

List Workspaces

Tool: list_workspaces
Parameters: {}
Response: ["default", "demo", "topp", "tiger", "sf"]

Get Layer Information

Tool: get_layer_info
Parameters: {
  "workspace": "topp",
  "layer": "states"
}

Query Features

Tool: query_features
Parameters: {
  "workspace": "topp",
  "layer": "states",
  "filter": "PERSONS > 10000000",
  "properties": ["STATE_NAME", "PERSONS"]
}

Generate a Map

Tool: generate_map
Parameters: {
  "layers": ["topp:states"],
  "styles": ["population"],
  "bbox": [-124.73, 24.96, -66.97, 49.37],
  "width": 800,
  "height": 600,
  "format": "png"
}

💻 Client Development

If you plan to develop your own client to interact with the GeoServer MCP Server, you can refer to the example client implementation examples/client.py. This example shows:

• How to establish a connection with the MCP Server
• How to send requests and handle responses
• How to use different tools for operations

🤝 Contribution Guidelines

Contributions to this project are welcome! Here are some ways to get involved:

1. Submit issue reports or feature requests.
2. Create pull requests to fix bugs or add new features.
3. Share the project and provide feedback.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

Support

If you find this project helpful, please support it in the following ways:

• Star or fork the repository: https://github.com/mahdihassani/geoserver-mcp
• Provide feedback or suggestions.
• Contribute code or documentation.

Thank you for your attention and support for the GeoServer MCP project!