01
QGIS と uv を準備
QGIS Desktopをインストールし、MCP ServerのPython環境管理にはuvを使います。QGIS側では後でQGIS MCP Pluginを有効化します。
GIS / QGIS / MCP / AI Workflow
QGIS MCP 連携デモ
QGIS MCP Plugin と qgis-mcp Server を使い、MCP対応AIクライアントから QGIS Desktop のレイヤ操作、 Processing解析、地図表示、結果確認を行うための導入ページです。 実務では、QGIS画面操作用の qgis-mcp と、安定したバッチ解析用の qgis_process MCP Server を併用する構成を想定します。
最終更新日: 2026-05-03
Overview
QGIS MCPでできること
QGIS DesktopをローカルPC上で起動し、QGIS MCP Pluginが受け口になります。 MCP対応クライアント側では qgis-mcp Server を登録し、自然言語からQGIS操作を呼び出します。 GeoPackage、GeoTIFF、DEM、流路線、保全対象ポリゴンなどを扱うGIS実務の前処理・確認作業に向いています。
- GeoPackage / Shapefile / GeoTIFF の読み込み、レイヤ一覧確認、CRS確認
- QGIS Processingのbuffer、clip、intersection、contour、raster clip等の実行
- DEM、流路線、砂防基準点、保全対象ポリゴンの前処理チェック
- 解析結果のスタイル設定、表示範囲調整、PNG/PDF出力
- 土石流・急傾斜区域設定ツールへつなぐ前処理・検証の自動化
Setup
導入手順
このZIPには、既存の qgis-mcp をローカルPCへ導入するためのセットアップスクリプトと、MCPクライアント設定例を追加しています。 QGIS MCPはロリポップ上で動かすものではなく、QGISを使う作業PC上で動かします。
02
qgis-mcp Server を取得
nkarasiak/qgis-mcpをローカルPCにcloneし、uv syncとinstall.pyでMCP ServerとQGIS Pluginを配置します。
03
QGIS側で Start Server
QGISを再起動し、プラグイン > QGIS MCPからパネルを開いてStart Serverを押します。標準ではlocalhost:9876を使います。
04
MCP Clientに登録
Claude Desktop、Cursor、VS CodeなどのMCP設定にqgis-mcp Serverを登録し、チャットからQGIS操作を実行します。
Windowsの基本実行例
cd C:\path\to\demo-godo-tys\mcp\qgis-mcp
powershell -ExecutionPolicy Bypass -File .\setup_qgis_mcp_windows.ps1実行後、QGISを再起動し、プラグイン管理画面で QGIS MCP を有効化してから、QGIS MCPパネルで Start Server を押します。
Client Config
MCPクライアント設定例
Claude Desktop、Cursor、VS Codeなどに qgis-mcp Server を登録します。
cwd は、ローカルPC上で clone した qgis-mcp フォルダに変更してください。
標準接続
QGIS側のPluginは localhost:9876 で待ち受け、MCP ServerがAIクライアントとQGISの間を中継します。
複数PCで共有する構成ではなく、まずは1台の作業PC内で閉じる運用がおすすめです。
読み込み中...Batch MCP Server
qgis_process MCP Serverも同梱
QGIS Desktopを画面操作する用途とは別に、安定した解析バッチ用として qgis_process を呼び出す小型MCP Serverを同梱しました。
バッファ、クリップ、交差、等高線、ラスタ切り出しなど、決められた処理だけをMCP toolとして公開する構成です。
読み込み中...
PythonソースはHTMLへ直接埋め込まず、public/code/qgis-mcp/ 配下の外部ファイルとして公開しています。
Download Files
追加した設定・補助ファイル
Webページ上から参照・ダウンロードできるように、設定例、起動スクリプト、テストプロンプト、READMEを public/code/qgis-mcp/ に配置しました。
ローカル実行用には同じ内容を mcp/qgis-mcp/ にも配置しています。
Windowsセットアップ /code/qgis-mcp/setup_qgis_mcp_windows.ps1 Linux/macOSセットアップ /code/qgis-mcp/install_qgis_mcp_linux.sh Claude Desktop設定例 /code/qgis-mcp/claude_desktop_config.sample.json Cursor設定例 /code/qgis-mcp/cursor_mcp_config.sample.json VS Code設定例 /code/qgis-mcp/vscode_mcp_config.sample.json qgis_process MCP Server /code/qgis-mcp/gis_qgis_process_mcp_server.py 動作確認プロンプト /code/qgis-mcp/qgis_mcp_test_prompts.md README /code/qgis-mcp/README_qgis_mcp.md
References
参考リンク
QGIS MCPの導入時は、QGIS Pluginページと qgis-mcp GitHubの最新READMEを確認してください。 MCPの仕様やPython SDKは公式ドキュメント・公式リポジトリも参照します。