JinDaGe - geoservercloud-mcp MCP Details

article

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密码 |

开发

有关本地开发、测试和发布的详细信息，请参阅开发者指南。

geoservercloud-mcp