Qgis MCP

🚀 QGISMCP - QGIS 模型上下文協議集成

QGISMCP 藉助模型上下文協議 (MCP)，將 QGIS 與 Claude AI 相連接，讓 Claude 能夠直接與 QGIS 進行交互並對其加以控制。通過這一集成，可實現提示輔助項目創建、圖層加載、代碼執行等功能。

該項目高度借鑑了 Siddharth Ahuja 開發的 BlenderMCP 項目。

✨ 主要特性

• 雙向通信：藉助基於套接字的服務器，實現 Claude AI 與 QGIS 的連接。
• 項目操作：可創建、加載和保存 QGIS 項目。
• 圖層操作：能向項目中添加或移除矢量或柵格圖層。
• 執行處理工具：可執行處理算法（處理工具箱）。
• 代碼執行：可在 QGIS 中運行任意 Python 代碼。此工具功能強大，但使用時需謹慎。

📚 詳細文檔

組件

該系統主要由以下兩個組件構成：

1. QGIS 插件：這是一個 QGIS 插件，它會在 QGIS 中創建一個套接字服務器，用於接收並執行命令。
2. MCP 服務器：這是一個 Python 服務器，它實現了模型上下文協議，並與 QGIS 插件相連接。

安裝

先決條件

• 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](https://docs.astral.sh/uv/getting-started/installation)

QGIS 插件安裝

您可以通過以下兩種方式安裝 QGIS 插件：

1. 使用 QGIS 官方插件庫 搜索並安裝 "qgis-mcp"。
2. 從源代碼編譯並安裝。

使用說明

命令列表

以下是可用命令及其簡要描述：

示例命令

以下示例展示瞭如何使用這些命令：

1. 使用 ping 檢查連接狀態。如果成功，則繼續下一步。
2. 創建新項目並在 "C:/Users/USER/GitHub/qgis_mcp/data/cdmx.qgz" 路徑保存。
3. 加載矢量圖層："C:/Users/