GDAL地理数据处理服务

gdal mcp

MCP服务器将GDAL/Rasterio操作暴露给AI代理，并带有反射 在执行操作之前需要结构化证明的中间件 其方法论很重要（CRS选择、重采样方法、查询范围）。

安装

通过uvx（推荐）

uvx --from gdal-mcp gdal --transport stdio

通过Docker

docker build -t gdal-mcp .
docker run -i gdal-mcp gdal --transport stdio

本地开发

git clone https://github.com/Wayfinder-Foundry/gdal-mcp.git
cd gdal-mcp
uv sync
uv run gdal --transport stdio

配置您的MCP客户端

克劳德桌面版

增添 claude_desktop_config.json （macOS： ~/Library/Application Support/Claude/, 窗户： %APPDATA%\Claude\，Linux： ~/.config/Claude/):

{
  "mcpServers": {
    "gdal-mcp": {
      "command": "uvx",
      "args": ["--from", "gdal-mcp", "gdal", "--transport", "stdio"],
      "env": {
        "GDAL_MCP_WORKSPACES": "/path/to/your/geospatial/data"
      }
    }
  }
}

重新启动克劳德桌面。MCP服务器指示灯应出现 raster_* 和 vector_* 工具变得可用。

工作区范围

GDAL_MCP_WORKSPACES 是以冒号分隔的服务器目录列表 允许触摸。如果未设置，则允许所有路径并记录警告。

可选工具表面标志： RASTER=true, VECTOR=true。参见 docs/环境变量.md 对于全套。

工具

• 光栅： raster_info, raster_convert, raster_reproject, raster_stats, raster_query
• 矢量： vector_info, vector_convert, vector_reproject, vector_clip, vector_buffer, vector_simplify, vector_query
• 资源： 目录(workspace://...)，元数据(metadata://...)，参考(reference://...)，查询结果(query://result/{id})
• 提示： justify_crs_selection, justify_resampling_method, justify_query_extent （以及更多 src/prompts/)

看 TOOLS.md 用于参数、返回形状和工作示例。

反射中间件

方法论重要的工具在调用代理之前拒绝执行 产生结构化的理由。流程为：

1. 代理人电话，例如。 raster_reproject(dst_crs="EPSG:3857", resampling="cubic", ...).
2. 中间件检查 .preflight/justifications/{domain}/ 以获得匹配的哈希值。
3. 关于小姐，电话响了 ToolError 有一个提示指向 相关提示（例如。 justify_crs_selection).
4. 客服呼叫提示符，填写 Justification 模式（意图， 考虑替代方案、选择、权衡、信心），并重新调用 带有a的工具 __reflection 有效载荷。
5. 理由是缓存域键控的，因此CRS的基本原理 EPSG:3857满足这两个条件 raster_reproject 和 vector_reproject 在随后的通话中。

看 docs/REFLECTION.md 对于模式和缓存布局， 和 docs/PHILOSOPHY.md 这是为什么存在的。

文档

• TOOLS.md --工具参考
• docs/环境变量.md --运行时配置
• docs/REFLECTION.md --反射中间件内部
• docs/PHILOSOPHY.md --设计理念与方向
• docs/ROADMAP.md --发布历史和方向
• 更改日志.md --版本更新日志
• 贡献.md --贡献指南

故障排除

Access denied: path outside allowed workspaces --set GDAL_MCP_WORKSPACES 包含有问题的目录（请参阅“工作区范围”）。

MCP客户端看不到服务器 --验证 uvx --from gdal-mcp gdal --help 独立运行，然后在编辑其配置文件后重新启动客户端。

许可证

麻省理工学院——见 许可证.

建立在 FastMCP, 栅格读写库, 平壤, 和 匀称.