MCP 服务器

QGISMCP

通过模型上下文协议将 QGIS 连接到 Claude AI，从而实现 AI 辅助的项目创建、图层操作、处理算法执行以及在 QGIS 中运行 Python 代码。

README

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

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

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

功能

双向通信：通过基于套接字的服务器将 Claude AI 连接到 QGIS。
项目操作：在 QGIS 中创建、加载和保存项目。
图层操作：向项目中添加和删除矢量或栅格图层。
执行处理：执行处理算法（处理工具箱）。
代码执行：从 Claude 在 QGIS 中运行任意 Python 代码。功能非常强大，但也请非常谨慎地使用此工具。

组件

该系统由两个主要组件组成：

QGIS 插件：一个 QGIS 插件，用于在 QGIS 中创建一个套接字服务器，以接收和执行命令。
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"
            ]
        }

    }
}

用法

启动连接

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

与 Claude 一起使用

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

Claude tools

工具

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. 保存项目。