GeoServer MCP Server

GeoServer MCP Server

site icon
2025.04.24 2
Python地图服务地理空间数据处理位置服务
GeoServer MCP Server 是一个实现 Model Context Protocol (MCP) 的服务,它将大型语言模型 (LLMs) 连接到 GeoServer REST API,使 AI 助手能够与地理空间数据和服务进行交互。该服务提供了查询和操作 GeoServer 工作区、图层和样式的能力,执行空间查询,生成地图可视化,并访问 OGC 兼容的 Web 服务 (WMS, WFS)。
View on GitHub

Overview

基本能力

产品定位

GeoServer MCP Server 是一个连接大型语言模型与地理空间数据的中间件,旨在通过 AI 助手简化地理空间数据的查询、操作和可视化。

核心功能

  • 查询和操作 GeoServer 工作区、图层和样式
  • 执行空间查询:支持对矢量数据进行空间查询
  • 生成地图可视化:能够创建样式化的地图图像
  • 访问 OGC 兼容的 Web 服务:支持 WMS 和 WFS 服务

适用场景

  • 地理空间数据分析:通过自然语言查询地理空间数据
  • 地图生成:快速生成定制化的地图可视化
  • 地理信息系统集成:将地理空间功能集成到 AI 助手中

工具列表

目录管理

  • list_workspaces - 获取可用工作区
  • create_workspace - 创建新工作区
  • get_layer_info - 获取详细的图层元数据
  • list_layers - 列出工作区中的图层
  • create_layer - 创建新图层
  • delete_resource - 删除资源

数据操作

  • query_features - 对矢量数据执行 CQL 查询

可视化

  • generate_map - 创建样式化的地图图像
  • create_style - 定义新的 SLD 样式

常见问题解答

  • 如何配置 GeoServer 连接? 通过环境变量或命令行参数设置 GeoServer 的 URL、用户名和密码。
  • 支持哪些客户端? 支持 MCP 兼容的客户端,如 Claude Desktop 和 Cursor。

使用教程

使用依赖

  • Python 3.10+
  • 运行中的 GeoServer 实例(需启用 REST API)
  • MCP 兼容的客户端(如 Claude Desktop)
  • geoserver-rest

安装教程

  1. 安装包:
pip install -e .
  1. 配置 GeoServer 连接: Linux/Mac:
export GEOSERVER_URL="http://localhost:8080/geoserver"
export GEOSERVER_USER="admin"
export GEOSERVER_PASSWORD="geoserver"

Windows PowerShell:

$env:GEOSERVER_URL="http://localhost:8080/geoserver"
$env:GEOSERVER_USER="admin"
$env:GEOSERVER_PASSWORD="geoserver"
  1. 启动服务器:
geoserver-mcp-server

调试方式

使用 --debug 参数启动服务器以启用调试模式:

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。