Mapsmith 🔨🗺️

Профессиональная геообработка для AI-агентов — с проверяемым происхождением.

Mapsmith — это открытый MCP-сервер, который предоставляет любому AI-агенту (Claude, ChatGPT, Copilot, Cursor или вашему собственному) реальные возможности GIS-анализа: не просто «сделай мне карту», а буферы, наложения, перепроецирования, зональную статистику, анализ рельефа и сетей — выполняемые детерминированными движками, никогда не галлюцинируемые моделью.

Спрашивайте результат. Агент выбирает инструменты. Каждый вывод несет свое полное происхождение.

Почему Mapsmith

• Настоящая геообработка, а не CRUD для карт. Построен на проверенном открытом геопространственном стеке (GDAL, GeoPandas, Shapely и другие: WhiteboxTools, PDAL, DuckDB Spatial, QGIS Processing через sidecar).

• Происхождение по замыслу. Каждый слой, который создает 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, оставь только участки в пределах 300 м от реки в rivers.gpkg, и дай мне результат с происхождением анализа.»

Инструменты (v0.1)

Каждый инструмент, который записывает вывод, также записывает <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 (изолированный подпроцесс): ~900 алгоритмов

• Инструмент выполнения кода в песочнице для длинного хвоста

• Удаленный сервер (Streamable HTTP + OAuth), прогресс длительных задач через MCP Tasks

• Отрисовка карт: доступные для публикации URL просмотрщика MapLibre, MCP Apps

Политика поддержки установки

Docker (или uvx на машине с работающими колесами) — единственный поддерживаемый путь установки. Нативные геопространственные зависимости на трех ОС — это черная дыра поддержки; вопросы о сломанных локальных окружениях будут перенаправлены сюда.

Лицензия

• Сервер и движки Mapsmith: AGPL-3.0-or-later (см. LICENSE)

• Клиентский SDK и определения схем инструментов (будущий sdk/): Apache-2.0

Вы можете свободно размещать Mapsmith на своем сервере навсегда. Если вы изменяете его и предлагаете как услугу, AGPL просит вас делиться своими изменениями — или свяжитесь с нами по поводу коммерческой лицензии.

«Mapsmith» является товарным знаком проекта Mapsmith — см. TRADEMARKS.md.