项目简介

QGIS MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在桥接 QGIS 地理信息系统软件和 Claude AI 大语言模型。它允许 Claude AI 通过标准化的 MCP 协议，调用 QGIS 的功能，实现诸如项目创建、图层管理、地理处理、地图渲染等任务，从而扩展 Claude AI 在地理空间分析和可视化领域的应用能力。

主要功能点

双向通信: 通过 Socket 套接字服务器连接 Claude AI 和 QGIS。
项目操作: 支持在 QGIS 中创建、加载和保存项目文件。
图层管理: 允许添加和移除矢量或栅格图层到 QGIS 项目中。
地理处理: 可以执行 QGIS Processing Toolbox 中的地理处理算法。
代码执行: 支持 Claude AI 在 QGIS 环境中运行任意 Python 代码，实现高级定制功能。
地图渲染: 将当前地图视图渲染为图像文件。
信息查询: 获取 QGIS 软件信息、项目信息、图层信息和要素属性等。

安装步骤

环境准备:
- 确保已安装 QGIS 3.x 版本 (推荐 3.22 或 3.34)。
- 安装 Claude Desktop 客户端。
- 确保安装 Python 3.10 或更高版本。
- 安装 'uv' 包管理器（用于 Python 包管理，参考 uv 安装指南）。
下载代码:
- 克隆 GitHub 仓库 'qgis_mcp_modify1' 到本地计算机。
安装 QGIS 插件:
- 将 'qgis_mcp_plugin' 文件夹复制到 QGIS 用户配置文件夹的 'python/plugins' 目录下。
  - 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” 插件。
配置 Claude Desktop:
- 打开 Claude Desktop 客户端，进入 'Settings' -> 'Developer' -> 'Edit Config' -> 'claude_desktop_config.json'。
- 在 'claude_desktop_config.json' 文件中，添加以下 JSON 配置，用于配置 QGIS MCP 服务器连接：

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "#请替换为 qgis_mcp_modify1 仓库的本地路径#",
                "run",
                "src/qgis_mcp/qgis_mcp_server.py"
            ]
        }
    }
}

注意: 请将 'args' 数组中的 '"请替换为 qgis_mcp_modify1 仓库的本地路径#"' 替换为 您克隆的 'qgis_mcp_modify1' 仓库在您电脑上的实际绝对路径。例如，如果仓库克隆在 'D:\GitHub\qgis_mcp_modify1'，则应修改为 '"D:/GitHub/qgis_mcp_modify1"' (注意 Windows 路径分隔符需使用 '/')。

基本使用方法

启动 QGIS MCP Server:
- 在 QGIS 软件中，点击菜单 “插件” -> “QGIS MCP” -> “QGIS MCP”，打开 QGIS MCP 面板。
- 在面板中，点击 “Start Server” 按钮，启动 QGIS MCP 服务器。
连接 Claude AI:
- 确保 Claude Desktop 客户端已正确加载 'claude_desktop_config.json' 配置文件。
- 在 Claude AI 对话界面中，您应该能看到一个锤子图标，点击后会显示 QGIS MCP 提供的工具列表。
使用工具:
- 在 Claude AI 中，通过自然语言指令调用 QGIS MCP 提供的工具，例如：
  - 'ping': 测试服务器连接。
  - 'load_project': 加载 QGIS 工程文件。
  - 'add_vector_layer': 添加矢量图层。
  - 'execute_processing': 执行地理处理算法。
  - 'render_map': 渲染地图为图片。
- 具体工具和使用方法可以参考仓库 README.md 文件中的 “Tools” 和 “Example Commands” 章节。

重要提示: 'execute_code' 工具允许 Claude AI 执行任意 PyQGIS 代码，具有强大的功能，但也存在潜在的安全风险，请谨慎使用。

关键词

项目简介

主要功能点

安装步骤

基本使用方法

信息