Mapsmith 🔨🗺️

AIエージェントのためのプロフェッショナルグレードのジオプロセッシング — 検証可能な来歴付き。

Mapsmithは、オープンソースのMCPサーバーであり、あらゆるAIエージェント（Claude、ChatGPT、Copilot、Cursor、独自のもの）に本格的なGIS分析機能を提供します。「地図を作って」という単純なものではなく、バッファ、オーバーレイ、再投影、ゾーン統計、地形およびネットワーク分析を実行します。これらは決定論的エンジンによって実行され、モデルによって幻覚（ハルシネーション）を起こすことはありません。

結果を依頼してください。エージェントがツールを選択します。すべての出力には完全な系統（リネージ）が付属します。

Mapsmithの理由

• 単なる地図のCRUDではなく、本物のジオプロセッシング。 実績のあるオープンな地理空間スタック（GDAL、GeoPandas、Shapely、そして今後追加予定: WhiteboxTools、PDAL、DuckDB Spatial、QGIS Processing via sidecar）上に構築されています。

• 設計による来歴（Provenance）。 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のアルゴリズム

• ロングテール向けのサンドボックス化されたコード実行ツール

• リモートサーバー（Streamable HTTP + OAuth）、MCP Tasksによる長時間ジョブの進捗

• 地図レンダリング：共有可能なMapLibreビューアURL、MCP Apps

インストールサポートポリシー

Docker（またはホイールが動作するマシンでのuvx）のみがサポートされるインストール方法です。 3つのOSにわたる地理空間ネイティブ依存関係はサポートのブラックホールです。ローカル環境の破損に関する問題は、こちらにリダイレクトされます。

ライセンス

• Mapsmithサーバーとエンジン：AGPL-3.0-or-later（LICENSEを参照）

• クライアントSDKとツールスキーマ定義（将来のsdk/）：Apache-2.0

Mapsmithは自由に、永遠にセルフホストできます。変更してサービスとして提供する場合、AGPLは変更内容の共有を求めます。または、商用ライセンスについてお問い合わせください。

「Mapsmith」はMapsmithプロジェクトの商標です — TRADEMARKS.mdを参照してください。