README
🚀 GeoServer MCP Server
GeoServer MCP Server是一个模型上下文协议(MCP)服务器,它通过Claude、VS Code Copilot等AI助手以及其他MCP兼容客户端,以自然语言交互的方式提供GeoServer REST API功能。
🚀 快速开始
GeoServer MCP Server通过包装 python-geoservercloud 库,将80多种GeoServer操作作为MCP工具公开。这使得AI助手能够通过自然语言命令管理GeoServer的工作区、数据存储、图层、样式等。
连接后,你可以向AI助手提出如下问题:
- "列出GeoServer中的所有工作区"
- "创建一个名为'test_data'的新工作区"
- "'topp'工作区中有哪些可用的图层?"
- "创建一个PostGIS数据存储连接"
📦 安装指南
从PyPI安装
pip install geoservercloud-mcp
或者使用 uvx 无需安装即可运行(需要 uv):
# 首先安装uv(如果尚未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 运行MCP服务器
uvx geoservercloud-mcp
从MCP注册表安装
此服务器已发布到 MCP注册表,名称为:
io.github.ronitjadhav/geoservercloud-mcp
💻 使用示例
连接到AI客户端
VS Code / Cursor
添加到你的MCP配置(.vscode/mcp.json):
{
"servers": {
"geoserver": {
"command": "uvx",
"args": ["geoservercloud-mcp"],
"env": {
"GEOSERVER_URL": "http://localhost:8080/geoserver",
"GEOSERVER_USER": "admin",
"GEOSERVER_PASSWORD": "geoserver"
}
}
}
}
Claude Desktop
添加到你的Claude Desktop配置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"geoserver": {
"command": "uvx",
"args": ["geoservercloud-mcp"],
"env": {
"GEOSERVER_URL": "http://localhost:8080/geoserver",
"GEOSERVER_USER": "admin",
"GEOSERVER_PASSWORD": "geoserver"
}
}
}
}
保存配置后重启Claude Desktop。
Python库使用
此MCP服务器基于 python-geoservercloud 库构建。若要在不使用MCP的情况下进行编程访问,请参阅 库文档。
from geoservercloud import GeoServerCloud
geoserver = GeoServerCloud(
url="http://localhost:8080/geoserver",
user="admin",
password="geoserver",
)
geoserver.create_workspace("my_workspace")
完整文档:https://camptocamp.github.io/python-geoservercloud/
📚 详细文档
环境变量
| 属性 | 详情 |
|------|------|
| GEOSERVER_URL | http://localhost:8080/geoserver | GeoServer基础URL |
| GEOSERVER_USER | admin | GeoServer用户名 |
| GEOSERVER_PASSWORD | geoserver | GeoServer密码 |
开发
有关本地开发、测试和发布的详细信息,请参阅 开发者指南。
微信扫一扫