Mapsmith 🔨🗺️

Geoprocesamiento de nivel profesional para agentes de IA, con procedencia verificable.

Mapsmith es un servidor MCP de código abierto que brinda a cualquier agente de IA (Claude, ChatGPT, Copilot, Cursor, o el tuyo propio) capacidades reales de análisis GIS: no solo "hazme un mapa", sino buffers, superposiciones, reproyecciones, estadísticas zonales, análisis de terreno y redes, ejecutados por motores deterministas, nunca alucinados por el modelo.

Pide el resultado. El agente elige las herramientas. Cada salida lleva su linaje completo.

Por qué Mapsmith

• Geoprocesamiento real, no CRUD de mapas. Construido sobre la pila geoespacial abierta probada (GDAL, GeoPandas, Shapely, y más por venir: WhiteboxTools, PDAL, DuckDB Spatial, QGIS Processing mediante sidecar).

• Procedencia por diseño. Cada capa que produce Mapsmith incluye un manifiesto de linaje legible por máquina: conjuntos de datos fuente (con sumas de verificación), cada herramienta ejecutada, parámetros exactos, decisiones de CRS, versiones de software, marcas de tiempo. Vuelve a ejecutarlo de manera idéntica bit a bit, sin el LLM. Sin basura de IA.

• El LLM orquesta, las herramientas computan. La geometría y los números solo provienen de ejecuciones deterministas de herramientas, nunca de la salida del modelo.

• Herramientas semánticas, no un volcado de herramientas. Un conjunto curado de herramientas a nivel de objetivo más un catálogo de operaciones buscable (descubrimiento progresivo), porque la precisión del agente colapsa cuando expones cientos de herramientas en bruto.

Related MCP server: NodeAPI

Inicio rápido

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

# or from PyPI
uvx mapsmith

Añadir a Claude Desktop / cualquier cliente MCP (stdio):

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

Luego pregúntale a tu agente cosas como:

"Toma parcels.gpkg, conserva solo las parcelas dentro de 300 m del río en rivers.gpkg, y dame el resultado con el linaje del análisis."

Herramientas (v0.1)

Cada herramienta que escribe una salida también escribe <output>.provenance.json junto a ella.

Ejemplo de procedencia

{
  "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"
}

Arquitectura

 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)             │
 └─────────────────────────────────────────────┘

Hoja de ruta

• Motor ráster (Rasterio): estadísticas zonales, recorte, sombreado, álgebra

• Adaptador de WhiteboxTools: terreno e hidrología (más de 500 herramientas permisivas)

• Sidecar de QGIS Processing (aislado por subprocesos): ~900 algoritmos

• Herramienta de ejecución de código en entorno aislado para la larga cola

• Servidor remoto (HTTP transmisible + OAuth), progreso de trabajos largos mediante MCP Tasks

• Renderizado de mapas: URLs de visor MapLibre compartibles, MCP Apps

Política de soporte de instalación

Docker (o uvx en una máquina con wheels funcionales) es la única ruta de instalación compatible. Las dependencias nativas geoespaciales en tres sistemas operativos son un agujero negro de soporte; los problemas sobre entornos locales rotos serán redirigidos aquí.

Licencia

• Servidor y motores de Mapsmith: AGPL-3.0-or-later (ver LICENSE)

• SDK de cliente y definiciones de esquema de herramientas (futuro sdk/): Apache-2.0

Puedes autoalojar Mapsmith libremente, para siempre. Si lo modificas y lo ofreces como servicio, la AGPL te pide que compartas tus cambios, o habla con nosotros sobre una licencia comercial.

"Mapsmith" es una marca registrada del proyecto Mapsmith — ver TRADEMARKS.md.