Mapsmith 🔨🗺️

Professionelle Geoverarbeitung für KI-Agenten — mit überprüfbarer Herkunft.

Mapsmith ist ein Open-Source-MCP-Server, der jedem KI-Agenten (Claude, ChatGPT, Copilot, Cursor oder Ihrem eigenen) echte GIS-Analysefunktionen bietet: nicht nur „mach mir eine Karte“, sondern Puffer, Überlagerungen, Reprojektionen, zonale Statistiken, Gelände- und Netzwerkanalyse — ausgeführt von deterministischen Engines, niemals vom Modell halluziniert.

Fragen Sie nach dem Ergebnis. Der Agent wählt die Werkzeuge. Jede Ausgabe trägt ihre vollständige Abstammung.

Warum Mapsmith

• Echte Geoverarbeitung, kein Karten-CRUD. Basierend auf dem bewährten offenen Geodaten-Stack (GDAL, GeoPandas, Shapely und weitere: WhiteboxTools, PDAL, DuckDB Spatial, QGIS Processing via Sidecar).

• Provenienz von Grund auf. Jeder Layer, den Mapsmith produziert, wird mit einem maschinenlesbaren Abstammungsmanifest ausgeliefert: Quelldatensätze (mit Prüfsummen), jedes ausgeführte Werkzeug, genaue Parameter, CRS-Entscheidungen, Softwareversionen, Zeitstempel. Führen Sie es bitidentisch erneut aus, ohne das LLM. Kein KI-Schrott.

• Das LLM orchestriert, Werkzeuge rechnen. Geometrie und Zahlen stammen ausschließlich von deterministischen Werkzeugausführungen — niemals aus der Modellausgabe.

• Semantische Werkzeuge, kein Werkzeug-Dump. Ein kuratierter Satz von Zielwerkzeugen plus ein durchsuchbarer Operationskatalog (progressive Entdeckung), da die Agentengenauigkeit zusammenbricht, wenn Sie Hunderte von rohen Werkzeugen freigeben.

Related MCP server: NodeAPI

Schnellstart

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

# or from PyPI
uvx mapsmith

Fügen Sie zu Claude Desktop / einem beliebigen MCP-Client (stdio) hinzu:

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

Bitten Sie dann Ihren Agenten um Dinge wie:

„Nimm parcels.gpkg, behalte nur die Parzellen innerhalb von 300 m des Flusses in rivers.gpkg und gib mir das Ergebnis mit der Analyse-Abstammung.“

Werkzeuge (v0.1)

Jedes Werkzeug, das eine Ausgabe schreibt, schreibt auch <output>.provenance.json daneben.

Provenienz-Beispiel

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

Architektur

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

Fahrplan

• Raster-Engine (Rasterio): zonale Statistiken, Clip, Hillshade, Algebra

• WhiteboxTools-Adapter: Gelände & Hydrologie (500+ permissive Werkzeuge)

• QGIS Processing Sidecar (Subprozess-isoliert): ~900 Algorithmen

• Sandboxed Code-Execution-Werkzeug für den langen Schwanz

• Remote-Server (Streamable HTTP + OAuth), Fortschritt langer Jobs über MCP Tasks

• Karten-Rendering: teilbare MapLibre-Viewer-URLs, MCP Apps

Installations-Support-Richtlinie

Docker (oder uvx auf einem Rechner mit funktionierenden Wheels) ist der einzige unterstützte Installationspfad. Geodaten-native Abhängigkeiten über drei Betriebssysteme hinweg sind ein Support-Schwarzes-Loch; Probleme mit defekten lokalen Umgebungen werden hierher umgeleitet.

Lizenz

• Mapsmith-Server und -Engines: AGPL-3.0-or-later (siehe LICENSE)

• Client-SDK und Werkzeug-Schema-Definitionen (zukünftig sdk/): Apache-2.0

Sie können Mapsmith frei und für immer selbst hosten. Wenn Sie es modifizieren und als Dienst anbieten, bittet die AGPL Sie, Ihre Änderungen zu teilen — oder sprechen Sie uns an bezüglich einer kommerziellen Lizenz.

„Mapsmith“ ist eine Marke des Mapsmith-Projekts — siehe TRADEMARKS.md.