GeoServer MCP 服务器

<p align="center"> <img src="https://badge.mcpx.dev?type=server" title="MCP 服务器"/> 这是一个实现了模型上下文协议 (MCP) 的服务器，它将大型语言模型 (LLMs) 连接到 GeoServer REST API，使 AI 助手能够与地理空间数据和服务进行交互。 </p> <div align="center"> <img src="docs/geoserver-mcp.png" alt="GeoServer MCP 服务器 Logo" width="400"/> </div>

版本 0.4.0（Alpha）正在积极开发中，并将很快发布。我们欢迎贡献者和开发者加入我们共同构建这个项目。

🎥 演示

<div align="center"> <img src="docs/demo/list_workspaces.png" alt="GeoServer MCP 服务器演示" width="400"/> </div>

📋 目录

• 功能
• 前提条件
• 安装
  • Docker 安装
  • pip 安装
  • 开发环境安装
• 可用工具
  • 工作区和图层管理
  • 数据操作
  • 可视化
• 客户端开发
  • 列出工作区
  • 获取图层信息
  • 查询要素
  • 生成地图
• 计划中的功能
• 贡献
• 许可证
• 相关项目
• 支持
• 徽章

🚀 功能

• 🔍 查询和操作 GeoServer 工作区、图层和样式
• 🗺️ 对矢量数据执行空间查询
• 🎨 生成地图可视化
• 🌐 访问 OGC 兼容的 Web 服务 (WMS, WFS)
• 🛠️ 与 MCP 兼容的客户端轻松集成

📋 前提条件

• Python 3.10 或更高版本
• 正在运行的 GeoServer 实例并启用了 REST API
• MCP 兼容的客户端（如 Claude Desktop 或 Cursor）
• 用于包安装的互联网连接

🛠️ 安装

选择最适合您需求的安装方法：

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 GeoServer MCP 服务器，请使用以下命令：

bash npx -y @smithery/cli install @mahdin75/geoserver-mcp --client claude

🛠️ Docker 安装

Docker 安装是运行 GeoServer MCP 服务器最快且最隔离的方式。它适用于：

• 快速测试和评估
• 生产部署
• 不希望依赖 Python 环境的情况
• 在不同系统上保持一致的部署

1. 运行 geoserver-mcp：

bash docker pull mahdin75/geoserver-mcp docker run -d mahdin75/geoserver-mcp

1. 配置客户端：

如果您使用的是 Claude Desktop，请编辑 claude_desktop_config.json。 如果您使用的是 Cursor，请创建 .cursor/mcp.json。

json { "mcpServers": { "geoserver-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GEOSERVER_URL=http://localhost:8080/geoserver", "-e", "GEOSERVER_USER=admin", "-e", "GEOSERVER_PASSWORD=geoserver", "-p", "8080:8080", "mahdin75/geoserver-mcp" ] } } }

🛠️ pip 安装

pip 安装推荐给大多数希望直接在系统上运行服务器的用户。此方法适用于：

• 希望在本地运行服务器的普通用户
• 已安装 Python 3.10+ 的系统
• 希望自定义服务器配置的用户
• 开发和测试目的

1. 安装 uv 包管理器。

bash pip install uv

1. 创建虚拟环境（Python 3.10+）：

Linux/Mac:

bash uv venv --python=3.10

Windows PowerShell:

bash uv venv --python=3.103. 使用 pip 安装包：

bash uv pip install geoserver-mcp

1. 配置 GeoServer 连接：

Linux/Mac:

bash export GEOSERVER_URL="http://localhost:8080/geoserver" export GEOSERVER_USER="admin" export GEOSERVER_PASSWORD="geoserver"

Windows PowerShell:

powershell $env:GEOSERVER_URL="http://localhost:8080/geoserver" $env:GEOSERVER_USER="admin" $env:GEOSERVER_PASSWORD="geoserver"

1. 启动服务器：

如果你将使用 Claude 桌面版，则不需要此步骤。对于 Cursor 或你自己的自定义客户端，你应该运行以下代码。

Linux:

bash source .venv/bin/activate

geoserver-mcp

或

bash source .venv/bin/activate

geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

Windows PowerShell:

bash ..venvScriptsactivate geoserver-mcp

或

bash ..venvScriptsactivate geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

1. 配置客户端：

如果你使用的是 Claude 桌面版，请编辑 claude_desktop_config.json。 如果你使用的是 Cursor，请创建 .cursor/mcp.json。

Windows:

json { "mcpServers": { "geoserver-mcp": { "command": "C:\path\to\geoserver-mcp\.venv\Scripts\geoserver-mcp", "args": [ "--url", "http://localhost:8080/geoserver", "--user", "admin", "--password", "geoserver" ] } } }

Linux:

json { "mcpServers": { "geoserver-mcp": { "command": "/path/to/geoserver-mcp/.venv/bin/geoserver-mcp", "args": [ "--url", "http://localhost:8080/geoserver", "--user", "admin", "--password", "geoserver" ] } } }

🛠️ 开发安装

开发安装是为贡献者和开发者设计的，他们希望修改代码库。这种方法适用于：

• 为项目做贡献的开发者
• 需要修改源代码的用户
• 测试新功能
• 调试和开发目的

1. 安装 uv 包管理器。

bash pip install uv

1. 创建虚拟环境（Python 3.10+）：

bash uv venv --python=3.10

1. 使用 pip 安装包：

bash uv pip install -e .

1. 配置 GeoServer 连接：

Linux/Mac:

bash export GEOSERVER_URL="http://localhost:8080/geoserver" export GEOSERVER_USER="admin" export GEOSERVER_PASSWORD="geoserver"

Windows PowerShell:

powershell $env:GEOSERVER_URL="http://localhost:8080/geoserver" $env:GEOSERVER_USER="admin" $env:GEOSERVER_PASSWORD="geoserver"

1. 启动服务器：

如果你将使用 Claude 桌面版，则不需要此步骤。对于 Cursor 或你自己的自定义客户端，你应该运行以下代码。

Linux:

bash source .venv/bin/activate

geoserver-mcp

或

bash source .venv/bin/activate

geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

Windows PowerShell:

bash ..venvScriptsactivate geoserver-mcp

或

bash ..venvScriptsactivate geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

1. 配置客户端：

如果你使用的是 Claude 桌面版，请编辑 claude_desktop_config.json。 如果你使用的是 Cursor，请创建 .cursor/mcp.json。

Windows:

json { "mcpServers": { "geoserver-mcp": { "command": "C:\path\to\geoserver-mcp\.venv\Scripts\geoserver-mcp", "args": [ "--url", "http://localhost:8080/geoserver", "--user", "admin", "--password", "geoserver" ] } } }

Linux:

json { "mcpServers": { "geoserver-mcp": { "command": "/path/to/geoserver-mcp/.venv/bin/geoserver-mcp", "args": [ "--url", "http://localhost:8080/geoserver", "--user", "admin", "--password", "geoserver" ] } } }## 🛠️ 可用工具

🛠️ 工作区和图层管理