QGISMCP - QGIS 模型上下文协议集成

QGISMCP 通过模型上下文协议 (MCP) 将 QGIS 连接到 Claude AI，允许 Claude 直接与 QGIS 交互并控制 QGIS。这种集成支持提示辅助的项目创建、图层加载、代码执行等。

本项目强烈基于 Siddharth Ahuja 的 BlenderMCP 项目。

功能

• 双向通信：通过基于套接字的服务器将 Claude AI 连接到 QGIS。
• 项目操作：在 QGIS 中创建、加载和保存项目。
• 图层操作：向项目中添加和删除矢量或栅格图层。
• 执行处理：执行处理算法（处理工具箱）。
• 代码执行：从 Claude 在 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

⚠️ 在安装 UV 之前不要继续

下载代码

将此存储库下载到您的计算机。您可以使用以下命令克隆它：

git clone git@github.com:jjsantos01/qgis_mcp.git

QGIS 插件

您需要将 qgis_mcp_plugin 文件夹及其内容复制到您的 QGIS 配置文件插件文件夹中。

您可以通过转到菜单 Settings -> User profiles -> Open active profile folder 在 QGIS 中获取您的配置文件文件夹。然后，转到 Python/plugins 并粘贴 qgis_mcp_plugin 文件夹。

在 Windows 机器上，插件文件夹通常位于： C:\Users\USER\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins，在 MacOS 上： ~/Library/Application\ Support/QGIS/QGIS3/profiles/default/python/plugins

然后关闭 QGIS 并重新打开它。转到菜单选项 Plugins -> Installing and Managing Plugins，选择 All 选项卡并搜索 "QGIS MCP"，然后选中 QGIS MCP 复选框。

Claude 桌面集成

转到 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 以包含以下内容：

如果您找不到“Developers tab”或 claude_desktop_config.json，请查看此文档。

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
                "run",
                "qgis_mcp_server.py"
            ]
        }

    }
}

用法

启动连接

1. 在 QGIS 中，转到 plugins -> QGIS MCP-> QGIS MCP
2. 单击 "Start Server"

与 Claude 一起使用

一旦在 Claude 上设置了配置文件，并且服务器在 QGIS 上运行，您将看到一个带有 QGIS MCP 工具的锤子图标。

工具

• ping - 简单的 ping 命令，用于检查服务器连接
• get_qgis_info - 获取有关当前安装的 QGIS 信息
• load_project - 从指定路径加载 QGIS 项目
• create_new_project - 创建一个新项目并保存它
• get_project_info - 获取当前项目信息
• add_vector_layer - 向项目中添加一个矢量图层
• add_raster_layer - 向项目中添加一个栅格图层
• get_layers - 检索当前项目中的所有图层
• remove_layer - 从项目中删除具有指定 ID 的图层
• zoom_to_layer - 缩放到指定图层的范围
• get_layer_features - 从矢量图层检索要素，可以选择限制数量
• execute_processing - 使用给定的参数执行处理算法
• save_project - 将当前项目保存到给定的路径
• render_map - 将当前地图视图渲染为图像文件
• execute_code - 执行作为字符串提供的任意 PyQGIS 代码

示例命令

这是我用于 演示 的示例：

您可以使用这些工具来处理 QGIS。您将执行以下操作：
	1. Ping 以检查连接。如果有效，请继续执行以下步骤。
	2. 创建一个新项目并将其保存在： "C:/Users/USER/GitHub/qgis_mcp/data/cdmx.qgz"
	3. 加载矢量图层：""C:/Users/USER/GitHub/qgis_mcp/data/cdmx/mgpc_2019.shp" 并将其命名为 "Colonias"。
	4. 加载栅格图层： "C:/Users/USER/GitHub/qgis_mcp/data/09014.tif" 并将其命名为 "BJ"
	5. 缩放到 "BJ" 图层。
	6. 在 "Colonias" 图层上执行质心算法。跳过几何检查。将输出保存到 "colonias_centroids.geojson"。
	7. 执行代码以使用 "Colonias" 图层中的 "POB2010" 字段创建分级统计地图。使用具有 5 个类别的分位数分类方法和 Spectral 颜色渐变。
	8. 将地图渲染到 "C:/Users/USER/GitHub/qgis_mcp/data/cdmx.png"
	9. 保存项目。