关键词

QGISClaudeAIGIS地理空间自动化

使用说明

项目简介

QGIS MCP Integration (QGISMCP) 项目旨在通过 Model Context Protocol (MCP) 协议，桥接 Claude AI 与开源地理信息系统软件 QGIS。这使得用户能够利用 Claude AI 的自然语言处理能力，以直观的指令控制和操作 QGIS，实现 GIS 任务的自动化。

主要功能点

  • 双向通信: 通过 Socket 服务器连接 Claude AI 和 QGIS，实现指令和数据的实时交互。
  • 项目管理: 支持 QGIS 项目的创建、加载和保存操作。
  • 图层操作: 允许 Claude AI 添加和移除矢量或栅格图层到 QGIS 项目中。
  • 处理算法执行: 集成 QGIS Processing Toolbox，支持 Claude AI 调用和执行地理处理算法。
  • 代码执行: 允许 Claude AI 在 QGIS 环境中执行 Python 代码，实现高级和定制化功能。

安装步骤

  1. 环境准备:

    • 确保已安装 QGIS 3.x 版本 (推荐 3.22 或更高版本)。
    • 确保已安装 Claude AI 桌面客户端。
    • 安装 Python 3.10 或更高版本。
    • 安装 'uv' 包管理器。 macOS 用户可以使用 'brew install uv'，Windows 用户请参考 uv 官网 安装。

  2. 下载代码:

  3. 安装 QGIS 插件:

    • 找到 QGIS 用户配置文件夹。在 QGIS 中，依次点击 “设置” -> “用户配置” -> “打开当前配置文件夹”。
    • 进入打开的文件夹，然后导航到 'python/plugins' 目录。
    • 将下载代码仓库中的 'qgis_mcp_plugin' 文件夹及其内容复制到 'python/plugins' 目录中。
    • 关闭并重新启动 QGIS。
    • 在 QGIS 菜单栏中，点击 “插件” -> “管理和安装插件”。
    • 在 “全部” 标签页中搜索 “QGIS MCP”，勾选 “QGIS MCP” 复选框以启用插件。

  4. 配置 Claude 桌面客户端:

    • 打开 Claude 桌面客户端，进入 “Settings” -> “Developer” -> “Edit Config” -> 'claude_desktop_config.json'。如果找不到 “Developer” 选项卡，请参考 MCP 官方文档。
    • 在 'claude_desktop_config.json' 文件中，添加以下 JSON 配置到 'mcpServers' 字段下：
    {
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp", // 将 "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp" 替换为代码仓库父文件夹的绝对路径，例如 "C:/Users/YourName/Documents/deepseek_qgis_mcp"
                "run",
                "qgis_mcp_server.py" // 注意：虽然实际服务器逻辑在 QGIS 插件中，但此处配置保持与仓库说明一致
            ]
        }
    }
}

    注意: 请务必将 '/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp' 替换为 实际的代码仓库父文件夹的绝对路径。

基本使用方法

  1. 启动 QGIS MCP 服务器:

    • 在 QGIS 软件中，点击菜单 “插件” -> “QGIS MCP” -> “QGIS MCP”，打开 QGIS MCP 面板。
    • 在面板中，点击 “Start Server” 按钮启动服务器。

  2. 在 Claude 中使用:

    • 确保 Claude 桌面客户端已正确配置并运行。
    • 如果 QGIS MCP 服务器在 QGIS 中成功启动，并且 Claude 客户端配置正确，您将在 Claude 的界面中看到一个带有锤子图标的工具栏，其中包含 QGIS MCP 的可用工具。
    • 通过 Claude 的提示框，使用自然语言指令指示 Claude 调用 QGIS 工具来执行 GIS 任务。例如，您可以指示 Claude 加载图层、执行分析、渲染地图等。

服务器配置 (JSON 格式，用于 MCP 客户端)

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp", // 请替换为实际路径
                "run",
                "qgis_mcp_server.py" // 请注意，实际服务器逻辑在 QGIS 插件中，此文件为空，但配置保持与仓库说明一致
            ]
        }
    }
}

关键词: QGIS, ClaudeAI, GIS, 地理空间, 自动化

信息

分类

AI与计算

访问项目