联动 QGIS 与 ArcGIS

让智能体直接操作你电脑上打开着的 QGIS、ArcGIS Pro、ArcMap。

每个插件的详情也可以在客户端「设置 → 插件」点开插件卡片查看。插件是否包含在你的会员方案中，以插件页和插件市场的标注为准。

QGIS

连接本机运行的 QGIS Desktop，加载与编辑图层、设置符号、运行 Processing 算法，并排版导出 PDF/PNG 地图。

内置插件，随安装包附带 · 版本 0.1.1

主要功能

• 工程与图层管理：打开、新建和保存 .qgs/.qgz 工程，加载 Shapefile、GeoPackage、GeoJSON、GeoTIFF 等数据及 XYZ、WMS、WFS 图层，管理图层组、顺序与显隐。
• 符号化与标注：按单一符号、分类（唯一值）或分级（数值区间）设置图层样式，可指定 QGIS 色带；配置标注字段、字号与颜色，可导入导出 QML 样式文件并保存地图主题。
• 打印布局与图集：新建打印布局，添加地图框、标题、图例、比例尺、图片（指北针、Logo）和属性表，导出 PDF、PNG、JPG 或 SVG，默认 300 DPI；可按覆盖图层逐要素导出 Atlas 图集。
• Processing 地理处理：检索并调用 QGIS Processing 算法（native、GDAL、GRASS、SAGA 等提供者），可对多组参数批量运行，也能把多步流程保存为 .model3 模型。
• 要素查询与编辑：按 QGIS 表达式筛选并分页读取要素（单次最多 50 条），做字段统计、跨已加载图层执行 SQL；可新增、修改、删除要素和字段，或执行 PyQGIS 代码处理未覆盖的操作。
• 数据导出与坐标转换：将图层导出为 GeoPackage、Shapefile、GeoJSON、GeoTIFF 等文件，导出时可指定目标 EPSG 重投影；也可在坐标系之间转换点坐标和范围，渲染当前画布为预览图。

支持范围

• 支持 QGIS Desktop 3.28 及以上版本，上游 QGIS MCP 声明兼容 3.28–4.x。
• 内置连接程序基于上游 qgis-mcp v0.4.5，需与 QGIS 内安装的 QGIS MCP 插件版本保持一致，版本不一致时工具调用可能报错。
• 运行平台为 Windows，插件通过注册表及 C:\Program Files\QGIS*、C:\OSGeo4W* 目录定位 QGIS。
• 可加载 QGIS 能打开的矢量（Shapefile、GeoPackage、GeoJSON 等）、栅格（GeoTIFF 等）及 XYZ、WMS、WFS 服务。
• 布局导出格式为 PDF、PNG、JPG、SVG；图集导出为单个多页 PDF，或逐要素输出 PNG、JPG、TIF。

使用前提

• 需在本机安装 QGIS Desktop 3.28 或更高版本，推荐 LTR 版 MSI 安装包并保持默认安装路径。
• 需在 QGIS「插件 → 管理并安装插件」中安装作者为 nkarasiak 的「QGIS MCP」插件并重启 QGIS，插件仓库不可达时可从 ZIP 安装。
• 每次使用前需打开 QGIS，并在 QGIS MCP 面板点击「Start Server」，使其监听 127.0.0.1:9876。
• 本机回环端口 9876 不能被防火墙、安全软件拦截或被其他程序占用。

可以这样说

• “在 QGIS 里加载 roads.shp 和 dem.tif，按道路等级分类设色”
• “新建一个 A4 横版布局，加图名、图例、比例尺、指北针，导出 300 DPI 的 PDF”
• “用 QGIS 的 Processing 做 500 米缓冲区”
• “按 district 图层逐区导出图集”

默认交给：采集专家、处理专家、遥感专家、WebGIS 专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。

一次性配置

1. 安装 QGIS Desktop 3.28 或更高版本，推荐 LTR 版的 MSI 安装包，保持默认安装路径。国内可以从南京大学镜像下载：https://mirrors.nju.edu.cn/qgis/windows/；
2. 打开 QGIS，菜单「插件 → 管理并安装插件」，搜索 QGIS MCP（作者 nkarasiak）并安装；插件仓库连不上时用「从 ZIP 安装」。装好后重启 QGIS；
3. 在 QGIS 的 QGIS MCP 面板点击「Start Server」，它会在本机 127.0.0.1:9876 上等待连接；
4. 回到 OpenGeodex，在「设置 → 插件」打开 QGIS 插件，点「重新检测」，显示可用即完成。

之后每次使用前，只需要打开 QGIS 并点一次「Start Server」。也可以直接问智能体“怎么安装 QGIS”，它会给出完整步骤。

提供的能力

QGIS 插件通过 QGIS MCP 连接你打开着的 QGIS，能力来自 QGIS 本身：工程的打开、新建、保存；图层的加载、分组、排序、显隐；符号化与标注；打印布局与图集导出；Processing 算法调用与批处理；要素查询、统计与编辑；图层导出与坐标转换；渲染当前画布作为预览。会修改工程、图层或写出文件的操作执行前同样会请你审批。

常见问题

• 提示“未检测到 QGIS MCP 连接”：确认 QGIS 已打开，并且在 QGIS MCP 面板点了「Start Server」；
• 端口 9876 被安全软件拦截或被其他程序占用时也会连不上，放行或关闭占用的程序后重试；
• QGIS 中安装的 QGIS MCP 插件版本与 OpenGeodex 内置的连接程序版本差别太大时，部分操作可能报错，可以把 QGIS MCP 更新到最新版。

ArcGIS Pro

连接已打开的 ArcGIS Pro 3.3–3.6，查看当前工程与图层，加载成果数据、调整视图，运行白名单地理处理并导出布局。

扩展插件，需在插件市场安装 · 版本 0.1.1

主要功能

• 工程与图层探查：读取 Pro 版本、当前工程、地图和图层清单；可查看单个图层的字段、要素数、几何类型和记录的 WKID，重名图层用唯一 URI 区分。
• 成果加入地图：把本机绝对路径的 SHP、GeoJSON、GPKG、TIFF/IMG、LYRX、KML/KMZ 或 .gdb 内要素类加入当前地图，可选加载后缩放；移除图层只删地图引用，不删源数据。
• 视图控制：缩放到图层、设置 2D 比例尺，或按显式给出的 WKID 设置显示范围，不猜测坐标系；3D 视图中不适用的操作会明确提示。
• 白名单地理处理：运行缓冲区、裁剪、相交、融合、投影五个 GP 工具，输入输出为绝对路径，已有输出拒绝覆盖；许可不足时原样带回 Pro 的报错信息。
• 布局导出：把工程中已有的 Layout 导出为 PDF 或 PNG，分辨率固定 300 DPI，目标文件已存在时拒绝覆盖。
• 本机通道与审批：经当前 Windows 用户专用的命名管道与 Add-in 通信，不开放 TCP 端口；加图、改视图、GP 和导出需用户审批，没有任意 Python/ArcPy 入口。

支持范围

• 支持 ArcGIS Pro 3.3–3.6（基于 3.3 SDK 构建）；3.0–3.2 及 3.7 以上会明确拒绝。
• 已在 ArcGIS Pro 3.6 上实机联测加载 SHP 图层；3.3–3.5 尚未实测。
• 加图格式为 .shp、.geojson、.gpkg、.tif/.tiff、.img、.lyrx、.kml/.kmz 及文件地理数据库（.gdb）内要素类；CSV 和 .json 报告不作为图层。
• 运行平台为 Windows x64，桥接程序以自包含 .NET 8 随包分发。

使用前提

• 需自行安装并授权 ArcGIS Pro 3.3–3.6；GP 运行受本机 Pro 授权与扩展许可约束。
• Add-in 安装：安装插件时若已检测到 Pro，会调用 Pro 自带的 RegisterAddin.exe 注册 OpenGeodex.ArcGISPro.esriAddinX，需在 Esri 弹出的安装确认窗口中确认，然后重启 Pro。
• 若安装插件时没有弹出 Esri 窗口、点了取消，或先装插件后装 Pro：关闭 Pro，双击插件目录 addin 文件夹里的 OpenGeodex.ArcGISPro.esriAddinX，在 Esri 窗口点「安装加载项」即可补装；不需要另装 .NET 等运行环境。
• 使用时 Pro 须已打开工程并激活地图视图，且与 OpenGeodex 在同一 Windows 用户下运行。

可以这样说

• “把 result.shp 加到 Pro 当前地图并缩放过去”
• “在 Pro 里对 roads 做 200 米缓冲区”
• “把工程里的「布局」导出成 PDF”

提供的工具

智能体会按任务自动选用下面的工具，你不需要记住它们的名字。写入类工具执行前会弹出审批卡片。

工具	类型
查看 Pro 版本、当前工程、地图、图层及图层字段详情	只读
向当前地图添加数据，切换图层显隐或移除图层引用	写入 · 需审批
缩放到图层、设置比例尺或按坐标系设定显示范围	写入 · 需审批
运行缓冲区、裁剪、相交、融合、投影或导出布局	写入 · 需审批

默认交给：处理专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。

安装与使用步骤

本机已安装并授权 ArcGIS Pro 3.3–3.6 即可，不需要另外安装 .NET 或其他运行环境。

1. 安装插件：在插件市场安装 ArcGIS Pro 插件。安装时会弹出 Esri 的「ArcGIS Add-In Installation Utility」窗口（可能在其他窗口后面，请留意任务栏），点「安装加载项（Install Add-In）」；
2. 重启 ArcGIS Pro：安装时 Pro 正开着的，需要完全退出后重新打开，加载项才会生效；
3. 使用前：在 Pro 中打开工程（.aprx），点一下要操作的地图标签页使它处于激活状态；需要导出布局时，工程里要先有布局（Pro 中「插入 → 新建布局」）。Pro 与 OpenGeodex 请用同一个 Windows 用户、以相同方式运行，不要只把其中一个“以管理员身份运行”。

补装加载项：安装插件时没看到 Esri 窗口、点了取消，或者先装插件后装 Pro 时，请关闭 Pro，到插件目录的 addin 文件夹里双击 OpenGeodex.ArcGISPro.esriAddinX，在 Esri 窗口点「安装加载项」，再重新打开 Pro。

常见提示

• 「ArcGIS Pro 没有运行」：先打开 Pro 和工程；
• 「OpenGeodex Add-in 还没有安装到 Pro」：按上面的「补装加载项」操作；
• 「Add-in 已安装，但正在运行的 Pro 没有加载它」：完全退出 Pro 后重开；仍不行时在 Pro 的「设置 → 加载项管理器」查看 OpenGeodex ArcGIS Pro Bridge 是否被安全设置阻止，被阻止的话在「选项」中允许加载后重启 Pro；
• 「Pro 正忙」或「没有返回结果」：切到 Pro，关闭弹出的对话框，等它空闲后重试；
• 「当前激活的不是地图视图」：在 Pro 中点一下地图标签页。

ArcGIS Map

连接已打开的 ArcMap 10.8，把 SHP/TIFF 成果加入当前地图、调整视图，运行白名单地理处理并导出 PDF/PNG。

扩展插件，需在插件市场安装 · 版本 1.1.0

主要功能

• 会话与图层读取：检查 ArcMap 是否运行、Add-in 是否加载及版本，读取当前焦点地图和图层清单；地图数据尚未就绪时由智能体等待后有限次重试。
• 成果加入地图：把本机绝对路径的 Shapefile、TIFF 或 IMG 加入当前数据框，可切换图层显隐或按图层名移除；JSON、报告等文件不作为地图图层加载。
• 视图控制：缩放到指定图层、设置比例尺分母，或按当前数据框坐标系给出 xmin/ymin/xmax/ymax 设置显示范围。
• 白名单地理处理：在 ArcMap 进程内运行缓冲区、裁剪、相交、融合四个 GP 工具，输入输出均为绝对路径，已有输出默认不覆盖；不开放任意 ArcPy 或脚本入口。
• 地图导出：把当前视图导出为 PDF 或 PNG，分辨率 72–600 DPI，默认 150 DPI，目标文件已存在时默认不覆盖。
• 本机通道与审批：通过仅限当前 Windows 用户访问的命名管道与 Add-in 通信；加图、移除图层、改视图、GP 和导出都是写操作，需用户审批。

支持范围

• 只支持 ArcMap（ArcGIS Desktop）10.8；10.7 及更早版本无法加载本插件，其他版本会明确拒绝。
• 已实测（此前面向 10.7 的构建，在 ArcMap 10.7、ArcInfo 许可下）：会话检查、SHP/TIFF 加图、图层与视图操作、缓冲区/裁剪/相交/融合和 PNG 导出，并回读了成果。
• 未实测：本 10.8 构建在 ArcMap 10.8 上的联测、PDF 导出、IMG 数据加图，以及其他许可级别和客户数据组合。
• 加图格式为 .shp、.tif/.tiff、.img；GP 的输入和叠加数据须为已存在的本机文件。
• 运行平台为 Windows。

使用前提

• 需在 Windows 上自行安装并授权 ArcGIS Desktop / ArcMap 10.8，插件不提供 ArcGIS 授权。
• 需要 .NET Framework 4.x，ArcMap 10.8 安装环境通常已具备。
• Add-in 安装：安装插件时会自动把 OpenGeodex.ArcMapBridge.esriAddIn 复制到当前用户的「文档\ArcGIS\AddIns\Desktop10.8」目录；未成功时，可用 Esri Add-In Installation Utility 手动安装插件包 addin 目录中的该文件。
• 需先安装 ArcMap 再安装本插件；ArcMap 后装时需重新安装本插件以部署 Add-in。
• 安装或更新 Add-in 后需重启 ArcMap；使用时 ArcMap 必须处于打开状态。
• OpenGeodex 与 ArcMap 须在同一 Windows 用户下运行，否则命名管道会拒绝连接。
• 若机构启用了 ArcGIS Add-in 安全策略，可能需在 Add-In Manager 中放行本 Add-in。

可以这样说

• “把 output.tif 加到 ArcMap 当前地图”
• “在 ArcMap 里把 parcels 按 boundary 裁剪”
• “把当前视图导出成 300 DPI 的 PNG”

提供的工具

智能体会按任务自动选用下面的工具，你不需要记住它们的名字。写入类工具执行前会弹出审批卡片。

工具	类型
查看 ArcMap 会话状态、能力、当前地图和图层清单	只读
向当前地图添加 SHP/TIFF/IMG，切换图层显隐或移除图层	写入 · 需审批
缩放到图层、设置比例尺或显示范围	写入 · 需审批
运行缓冲区、裁剪、相交、融合，或导出 PDF/PNG 地图	写入 · 需审批

默认交给：处理专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。