Skip to main content
Glama
mapsmith-ai

Mapsmith

Official
by mapsmith-ai

Mapsmith 🔨🗺️

面向AI代理的专业级地理处理——结果可验证溯源。

Mapsmith 是一个开源 MCP 服务器,为任何 AI 代理(Claude、ChatGPT、Copilot、Cursor 或您自己的代理)提供真正的 GIS 分析能力:不仅仅是“给我一张地图”,而是缓冲区、叠加、重投影、分区统计、地形和网络分析——由确定性引擎执行,而非模型幻觉。

提出需求。代理选择工具。每个输出都携带完整的溯源信息。

为什么选择 Mapsmith

  • 真正的地理处理,而非地图增删改查。 基于成熟的开源地理空间技术栈(GDAL、GeoPandas、Shapely,未来还将加入:WhiteboxTools、PDAL、DuckDB Spatial、通过 sidecar 运行的 QGIS Processing)。

  • 溯源设计。 Mapsmith 生成的每个图层都附带机器可读的溯源清单:源数据集(含校验和)、执行的每个工具、精确参数、CRS 决策、软件版本、时间戳。无需 LLM 即可按位精确重放。杜绝 AI 垃圾。

  • LLM 编排,工具计算。 几何图形和数值仅来自确定性工具执行——绝不来自模型输出。

  • 语义化工具,而非工具堆砌。 精心策划的目标级工具集,加上可搜索的操作目录(渐进式发现),因为暴露数百个原始工具会导致代理准确率崩溃。

Related MCP server: NodeAPI

快速开始

# Docker (the supported path)
docker run -i --rm -v $(pwd)/data:/data ghcr.io/mapsmith-ai/mapsmith

# or from PyPI
uvx mapsmith

添加到 Claude Desktop / 任何 MCP 客户端(stdio):

{
  "mcpServers": {
    "mapsmith": {
      "command": "uvx",
      "args": ["mapsmith"]
    }
  }
}

然后向您的代理提出类似这样的需求:

“获取 parcels.gpkg,仅保留 rivers.gpkg 中河流 300 米范围内的地块,并向我提供结果及其分析溯源信息。”

工具(v0.1)

工具

功能说明

describe_dataset

任何矢量数据集的 CRS、几何类型、模式、范围、要素数量

buffer_layer

公制缓冲区,对地理 CRS 自动估算 UTM 投影

clip_layer

使用掩膜图层裁剪图层

reproject_layer

重投影到任意 CRS(EPSG 代码或 WKT)

spatial_join

按空间谓词(相交/包含于/包含)连接属性

get_provenance

返回任何 Mapsmith 输出的完整溯源清单

list_operations

可搜索的操作目录(渐进式发现)

每个写入输出的工具还会在其旁边写入 <output>.provenance.json

溯源示例

{
  "mapsmith_version": "0.1.0",
  "operation": "buffer_layer",
  "parameters": {"distance_meters": 300.0},
  "inputs": [{"path": "rivers.gpkg", "sha256": "9f2c…", "crs": "EPSG:4326"}],
  "crs_decisions": {"analysis_crs": "EPSG:32632", "reason": "estimated UTM zone for metric buffering"},
  "engine": {"name": "geopandas", "version": "1.0.1"},
  "started_at": "2026-08-18T10:15:03Z",
  "finished_at": "2026-08-18T10:15:04Z"
}

架构

 AI agent (Claude / ChatGPT / Copilot / your app)
        │  MCP (stdio local · Streamable HTTP remote)
        ▼
 ┌─────────────────────────────────────────────┐
 │ Mapsmith server                             │
 │  · semantic tools + operation catalog       │
 │  · parameter validation, CRS discipline     │
 │  · provenance recorder (lineage manifests)  │
 ├─────────────────────────────────────────────┤
 │ Engines                                     │
 │  · vector: GeoPandas/Shapely (built-in)     │
 │  · raster: Rasterio (roadmap)               │
 │  · terrain/hydro: WhiteboxTools (roadmap)   │
 │  · qgis_process / GRASS sidecar (roadmap,   │
 │    GPL-isolated via subprocess)             │
 └─────────────────────────────────────────────┘

路线图

  • 栅格引擎(Rasterio):分区统计、裁剪、山体阴影、代数运算

  • WhiteboxTools 适配器:地形与水文(500+ 宽松许可工具)

  • QGIS Processing sidecar(子进程隔离):约 900 个算法

  • 沙盒化代码执行工具,用于长尾需求

  • 远程服务器(Streamable HTTP + OAuth),通过 MCP Tasks 实现长任务进度

  • 地图渲染:可分享的 MapLibre 查看器 URL、MCP Apps

安装支持策略

Docker(或 uvx 在可正常编译 wheel 的机器上)是唯一支持的安装方式。 跨三个操作系统的地理空间原生依赖是支持黑洞;关于本地环境损坏的问题将被重定向至此。

许可证

  • Mapsmith 服务器和引擎:AGPL-3.0-or-later(见 LICENSE

  • 客户端 SDK 和工具模式定义(未来 sdk/ 目录):Apache-2.0

您可以永久免费自托管 Mapsmith。如果您修改它并将其作为服务提供,AGPL 要求您分享您的更改——或联系我们了解商业许可证。

“Mapsmith”是 Mapsmith 项目的商标——见 TRADEMARKS.md

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    Machine-native GIS processing API for AI agents and developers. Convert, reproject, validate, repair, buffer, clip, dissolve, and tile vector geodata across 25 endpoints. Pay-per-use USDC on Solana Mainnet ($0.01/op). No accounts, no API keys. Remote MCP SSE.
  • F
    license
    -
    quality
    D
    maintenance
    Exposes ArcGIS Pro geoprocessing capabilities to LLMs via the arcpy library, enabling automated spatial analysis and data management. It provides a comprehensive suite of tools for vector geoprocessing, terrain analysis, and raster operations designed for GIS workflows.
    4
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI agents to become geospatially intelligent assistants with tools for location search, smart routing, round trip planning, reverse geocoding, isochrone analysis, route visualization, geofence management, and interactive map display.
    8
    37
    7
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • Deterministic reasoning stack for AI agents: simulate, decide & compute, plus cross-domain tools.

  • Precision math engine for AI agents. 203 exact methods. Zero hallucination.

  • Build, validate, and deploy multi-agent AI solutions from any AI environment.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mapsmith-ai/mapsmith'

If you have feedback or need assistance with the MCP directory API, please join our Discord server