返回 MCP 目录
public公开dns本地运行

geoservercloud-mcp

一个基于GeoServer REST API的MCP服务器,通过自然语言交互让AI助手管理地理空间数据工作区、数据存储、图层和样式等资源。

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

开发

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端