QGISMCP - QGIS 模型上下文协议集成 (从 https://github.com/jjsantos01/qgis_mcp 更新的版本)

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

该项目主要基于 (https://github.com/jjsantos01/qgis_mcp)。我只是更新了一些我发现的错误。

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

特性

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

组件

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

1. QGIS 插件: 一个 QGIS 插件，它在 QGIS 中创建一个套接字服务器来接收和执行命令。
2. MCP 服务器: 一个 Python 服务器，它实现了模型上下文协议并连接到 QGIS 插件。

安装

前提条件

• QGIS 3.X (仅在 3.22 和 3.34 上测试过)
• 云桌面
• 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 之前不要继续

下载代码

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

https://github.com/syauqi-uqi/qgis_mcp_modify1.git

QGIS 插件

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

您可以通过转到菜单 设置 -> 用户配置文件 -> 打开活动配置文件文件夹 在 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 并再次打开它。转到菜单选项 插件 -> 安装和管理插件，选择 全部 选项卡并搜索 "QGIS MCP"，然后标记 QGIS MCP 复选框。

Claude 桌面集成

转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 以包含以下内容：

如果您找不到“开发者选项卡”或 claude_desktop_config.json，请查看此 文档。

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "#将此行更改为您的目录#",
                "run",
                "qgis_mcp_server.py"
            ]
        }

    }
}

用法

启动连接

1. 在 QGIS 中，转到 插件 -> QGIS MCP-> QGIS MCP
2. 单击“启动服务器”

与 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 代码

示例命令

这是我用于 演示 的示例： 或者，对于此更新版本，请参见 (https://www.linkedin.com/posts/syauqi-arka-yudisti-73b236288_qgis-ai-vibemapping-activity-7316248625045483524-hQdB?utm_source=share&utm_medium=member_android&rcm=ACoAAEXNN58BLMyjf4iZIy1KZZJBUFyiNlLtNSg)

您可以使用这些工具来处理 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. 保存项目。

我的版本中的另一个示例命令

您可以使用这些工具来处理 QGIS。您将执行以下操作：

1. **Ping 以检查连接**。如果成功，请继续。

2. **创建一个新的 QGIS 项目** 并将其保存到：
   **"D:/PROJECT/MCP/claudemap.qgz"** (使用斜杠 `/` 以获得兼容性)。

3. **加载矢量图层**:
   a. 加载 **"D:/PROJECT/MCP/map (2).osm"** (OSM 图层将分为 `points`、`lines`、`multilinestrings`、`multipolygons`)。
   b. 加载 **"D:/PROJECT/MCP/Bahan_Mundupesisir/aoi.shp"** 并将其命名为 **"aoi"**。

4. **缩放到 "aoi" 图层** 以设置初始范围。

5. **删除/隐藏不必要的图层**:
   a. 删除图层 **"map (2) — points"** (右键单击 > 删除图层)。
   b. 隐藏图层 **"aoi"** (以保持范围但不将其显示在地图上)。

6. **样式图层**:
   a. **"map (2) — lines"**:
      - 线条颜色: **#ff6201** (橙色)
      - 笔画宽度: **0.5 mm**
   b. **"map (2) — multilinestrings"**:
      - 线条颜色: **#8bff07** (霓虹绿)
      - 笔画宽度: **0.8 mm**
   c. **"map (2) — multipolygons"**:
      - 填充颜色: **#fff65f** (淡黄色)
      - 笔画颜色: **#fff65f** (与填充相同)
      - 笔画宽度: **0.3 mm**
      - 透明度: **80%**

7. **创建打印布局 (A4 纵向)**:
   a. 添加 **地图项目**，尺寸为 A4 (210x297 mm)。
   b. 将 **比例设置为 1:10,000** 并启用 **"锁定地图项目的图层"**。
   c. 添加 **标题**:
      - 文本: **"PETA MUNDUPESISIR BY CLAUDE.AI"**
      - 字体: **粗体, 24pt**
      - 位置: 顶部居中。
   d. 添加 **比例尺** 和 **图例** (可选)。

8. **导出为 PNG**:
   - 路径: **"D:/PROJECT/MCP/claudemap.png"**
   - 分辨率: **600 DPI** (确保文件大小不太大)。

9. **保存 QGIS 项目**。