← 返回目录

QGISMCP

社区

通过模型上下文协议（MCP）连接 Claude AI 与 QGIS Desktop。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 217 / 230
Stars: ★ 1.1k 热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+
凭据: 无需凭据
最近提交: 12 个月前 ⚠
工具数: 15

30FMRS · D

通过 MCP 将 QGIS 与 Claude AI 集成的实用服务器，提供广泛工具实现 GIS 自动化。但需要直接访问 QGIS 桌面和任意代码执行，存在安全风险，不适用于新手或不安全的环境。

最强项 · 安装易用性 10/20 最弱项 · 安全与权限 3/20

可靠性

4/20

安全与权限

3/20

维护活跃度

3/20

文档质量

10/20

安装易用性

10/20

查看各项评分依据

可靠性 4/20: 仅提供 README，未含服务器源码、测试或 CI，无法验证 MCP 初始化握手和工具列表是否真实匹配行为；工具声明与实现一致性无证据。happy path 看起来可行，但缺少可复现性和错误路径证据，因此从低评分。
安全与权限 3/20: 存在 execute_code 工具，允许 LLM 在 QGIS 中执行任意 PyQGIS 代码；README 未提及任何确认/审批机制，socket server 也未描述认证或数据边界。这属于未确认的远程命令执行风险，触发 0-4 红线范围，故给 3 分。
维护活跃度 3/20: 仓库未归档且有 16 个 open issues，但缺少提交、发布或版本管理证据；license 未知，也没有安全响应渠道。不能仅凭 star 数加分，维护治理证据不足，因此评分偏低。
文档质量 10/20: README 提供安装前置条件、QGIS 插件复制、Claude Desktop 配置、工具列表和完整示例，整体可用；但缺少故障排查、工具参数细节、局限性和权限/数据流说明，也隐含绝对路径等未解释假设。
安装易用性 10/20: 安装步骤清晰，包含 uv、QGIS 插件复制和 Claude Desktop JSON 配置示例；但全部为手动复制和手工配置，无自动化安装或 CI 验证，跨平台路径有示例但仍属脆弱流程。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

希望利用 Claude AI 通过自然语言交互来控制和自动化 QGIS 任务的 GIS 用户和开发者。
熟悉 QGIS 和 Python，希望简化工作流程的人。
需要自动化复杂 GIS 操作（如加载图层、运行处理算法和生成地图）的用户。

不适合谁

希望使用 QGIS 的公共服务器或云服务的用户。
不熟悉 QGIS 和 PyQGIS 的初学者。
需要生产级或企业级支持的用户。
不适合在不使用 QGIS 桌面环境的情况下运行。

所需权限

文件系统访问：加载和保存项目、读取图层文件、渲染地图。
网络访问：MCP 服务器与 QGIS 插件之间的套接字通信。
执行代码：execute_code 允许在 QGIS 环境中运行任意 Python 代码，具有与 QGIS 相同的权限。

风险与副作用

执行任意代码可能带来安全风险，如果提示被恶意引导，可能会导致数据丢失或系统损坏。
处理大型数据集时，可能意外覆盖项目或输出文件。
QGIS MCP 插件和 MCP 服务器之间的通信未加密，可能在本地网络中被拦截。
插件和服务器未经官方 QGIS 项目或 Claude 认证，可能存在错误或未维护。

安装接入

准备工作

运行环境：Python 3.10+

先决条件：QGIS 3.X（仅在 3.22 上测试过）、Claude Desktop、Python 3.10 或更新版本、uv 包管理器。安装 uv 后，克隆仓库，将 qgis_mcp_plugin 文件夹复制到 QGIS 配置文件的插件目录，然后在 QGIS 的插件管理器中启用 QGIS MCP 插件。对于 Claude Desktop，编辑 claude_desktop_config.json 添加 MCP 服务器配置，指定 uv 命令和指向 src/qgis_mcp/qgis_mcp_server.py 的绝对路径。

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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add qgis -- uv --directory /ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp run qgis_mcp_server.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 QGIS 中启动 QGIS MCP 插件的 socket 服务器后，在 Claude 桌面端应能看到锤子图标及 QGIS MCP 工具列表；调用 ping 工具返回成功即证明连接正常。

常见排障

确保 QGIS 插件已正确安装并启用，必要时重新启动 QGIS。
确保 MCP 服务器已在 QGIS 中启动（插件菜单 → QGIS MCP → 开始服务器）。
检查 Claude Desktop 配置中的命令和路径是否正确，特别是绝对路径。
确保 uv 已安装并在 PATH 中，或使用完整路径。
检查防火墙或安全软件是否阻止 QGIS 和 Python 之间的本地套接字通信。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

Ping 一下检查与 QGIS 的连接是否正常。
创建一个新项目并保存到我的文档文件夹，然后加载一个矢量图层并命名为“测试图层”。
列出当前项目中的所有图层，并显示“人口”图层的前 10 条要素。
在“城市”图层上执行质心算法，把地图渲染为 PNG 图片，然后保存项目。

工具能力 15

ping 只读

简单的 ping 命令，用于检查服务器连接。

get_qgis_info 只读

获取当前 QGIS 安装的信息。

load_project 只读

从指定路径加载 QGIS 项目。

create_new_project 写入

创建新项目并保存。

get_project_info 只读

获取当前项目信息。

add_vector_layer 写入

向项目添加矢量图层。

add_raster_layer 写入

向项目添加栅格图层。

get_layers 只读

检索当前项目中的所有图层。

展开其余 7 个工具

remove_layer 破坏性

按 ID 从项目中移除图层。

zoom_to_layer 只读

放大到指定图层的范围。

get_layer_features 只读

从矢量图层检索要素，可限制数量。

execute_processing 写入

使用给定参数执行处理算法。

save_project 写入

将当前项目保存到指定路径。

render_map 写入

将当前地图视图渲染为图像文件。

execute_code 破坏性

执行任意 PyQGIS 代码（以字符串形式提供）。

使用场景

提示辅助的 GIS 项目创建和图层管理。

运行空间分析处理算法。

通过自然语言指令执行 PyQGIS 代码。

渲染地图以进行可视化。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

QGISMCP 通过模型上下文协议（MCP）将 QGIS 连接到 Claude AI，使 Claude 能够直接与 QGIS 交互并控制它。该集成支持通过提示协助创建项目、加载图层、执行代码等。该项目主要基于 BlenderMCP 项目。它包含两个主要组件：一个 QGIS 插件（在 QGIS 内创建套接字服务器以接收和执行命令）和一个 MCP 服务器（实现 MCP 协议并连接到插件）。