Mapsmith 🔨🗺️

AI 에이전트를 위한 전문가 수준의 지리정보 처리 — 검증 가능한 출처와 함께.

Mapsmith는 오픈소스 MCP 서버로, 모든 AI 에이전트(Claude, ChatGPT, Copilot, Cursor 또는 자체 에이전트)에게 실제 GIS 분석 기능을 제공합니다. 단순한 "지도 만들기"가 아니라 버퍼, 오버레이, 재투영, 구역 통계, 지형 및 네트워크 분석을 수행하며, 이 모든 작업은 결정론적 엔진에 의해 실행되며 모델이 환각을 일으키지 않습니다.

결과를 요청하세요. 에이전트가 도구를 선택합니다. 모든 출력물은 전체 계보(lineage)를 담고 있습니다.

Mapsmith를 선택해야 하는 이유

• 지도 CRUD가 아닌 실제 지리정보 처리. 검증된 오픈 지리정보 스택(GDAL, GeoPandas, Shapely 및 향후 추가 예정: WhiteboxTools, PDAL, DuckDB Spatial, 사이드카를 통한 QGIS Processing)을 기반으로 구축되었습니다.

• 설계에 의한 계보(Provenance by design). 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의 강으로부터 300m 이내에 있는 필지만 유지하고, 분석 계보와 함께 결과를 제공해줘."

도구 (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개 알고리즘

• 긴 꼬리(long tail)를 위한 샌드박스 코드 실행 도구

• 원격 서버 (Streamable HTTP + OAuth), MCP Tasks를 통한 장기 작업 진행 상황

• 지도 렌더링: 공유 가능한 MapLibre 뷰어 URL, MCP 앱

설치 지원 정책

Docker (또는 작동하는 휠이 있는 머신에서 uvx)만 지원되는 설치 경로입니다. 세 가지 OS에 걸친 지리정보 네이티브 종속성은 지원 블랙홀이며, 로컬 환경 문제에 대한 이슈는 여기로 리디렉션됩니다.

라이선스

• Mapsmith 서버 및 엔진: AGPL-3.0-or-later (LICENSE 참조)

• 클라이언트 SDK 및 도구 스키마 정의 (향후 sdk/): Apache-2.0

Mapsmith를 자유롭게, 영구적으로 자체 호스팅할 수 있습니다. 수정하여 서비스로 제공하는 경우 AGPL은 변경 사항을 공유하거나 상업용 라이선스에 대해 문의할 것을 요구합니다.

"Mapsmith"는 Mapsmith 프로젝트의 상표입니다. TRADEMARKS.md를 참조하세요.