Qgis MCP

🚀 QGISMCP - QGIS モデルコンテキストプロトコル統合

QGISMCP は、QGIS を Claude AI にモデルコンテキストプロトコル (MCP) を介して接続し、Claude が直接 QGIS とやり取りし、QGIS を制御できるようにします。この統合により、プロジェクトの作成、レイヤーの読み込み、コードの実行などの機能をプロンプトで支援することが可能になります。

このプロジェクトは、Siddharth Ahuja による BlenderMCP プロジェクトを強くベースにしています。

✨ 主な機能

• 双方向通信：ソケットベースのサーバーを通じて、Claude AI を QGIS に接続します。
• プロジェクト操作：QGIS プロジェクトの作成、読み込み、保存ができます。
• レイヤー操作：ベクターまたはラスターレイヤーをプロジェクトに追加または削除できます。
• 処理ツールの実行：処理アルゴリズム（処理ツールボックス）を実行します。
• コード実行：QGIS 内で任意の Python コードを実行できます。非常に強力ですが、このツールは慎重に使用してください。

🔧 コンポーネント

このシステムは 2 つの主要なコンポーネントで構成されています。

1. QGIS プラグイン：QGIS 内でソケットサーバーを作成し、コマンドを受信して実行する QGIS プラグインです。
2. MCP サーバー：モデルコンテキストプロトコルを実装し、QGIS プラグインと接続する Python サーバーです。

📦 インストール

前提条件

• QGIS 3.X（3.22 でのみテスト済み）
• クラウドデスクトップ
• Python 3.10 以上
• uv パッケージマネージャー：

Mac を使用する場合は、次のように uv をインストールします。

brew install uv

Windows Powershell では、

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

それ以外の場合は、公式サイトのインストール手順を参照してください：uv のインストール

QGIS プラグインのインストール

QGIS プラグインをインストールするには、次の方法があります。

1. QGIS 公式プラグインライブラリ を使用して、"qgis-mcp" を検索してインストールします。
2. または、ソースコードからコンパイルしてインストールします。

💻 使用例

コマンドリスト

以下は使用可能なコマンドのリストとその簡単な説明です。

• ping：接続状態を確認します。
• create_new_project：新しいプロジェクトを作成し、指定されたパスに保存します。
• load_vector_layer：ベクターレイヤーを読み込み、名前を指定します。
• load_raster_layer：ラスターレイヤーを読み込み、名前を指定します。
• get_layers：現在のプロジェクト内のすべてのレイヤーを取得します。
• remove_layer：ID を指定してレイヤーを削除します。
• zoom_to_layer：指定されたレイヤーの範囲にズームします。
• execute_processing：処理アルゴリズムを実行し、パラメーターを指定します。
• save_project：現在のプロジェクトを指定されたパスに保存します。
• render_map：現在の地図ビューをレンダリングし、画像ファイルとして保存します。
• execute_code：任意の PyQGIS コードを実行します。

サンプルコマンド

以下は、これらのコマンドの使用方法を示す例です。

1. ping を使用して接続状態を確認します。成功した場合は、次の手順に進みます。
2. 新しいプロジェクトを作成し、「C:/Users/USER/GitHub/qgis_mcp/data/cdmx.qgz」に保存します。
3. ベクターレイヤーを読み込みます：「C:/Users/