gis-agent-bridges

A family of small, safety-gated bridges that let AI agents operate mainstream GIS software — headless inventory/backup plus, where the vendor API allows, a live in-app MCP bridge — all in one repo for easy reuse.

一个把主流 GIS 软件的「AI Agent 桥」收在一起的合集仓库：每个软件一个子目录， 形态统一为两种——无头桥（在软件进程外盘点、备份工程文件，只对副本动手）， 以及在厂商 API 允许时的应用内实时 MCP 桥（桥脚本跑在软件进程内，Agent 经 MCP 协议操作你当前正打开的工程）。所有写操作都带确认闸，所有能力都如实标注。

项目由来

这两年，CAD、Blender 等工科软件陆续出现让 AI Agent 直接接入、操作当前工程 的服务，GIS/遥感这边基本还是空白。这个仓库想把主流 GIS 软件的桥都做出来、 放在一起，方便有需要的人直接取用——不管你手头是国产的 SuperMap、MapGIS， 还是 Esri 的 ArcGIS、开源的 QGIS，或是 ENVI、FME 这类处理工具。

Related MCP server: Agent中国通

软件矩阵

统一设计原则

• 只在本机：应用内桥只监听 127.0.0.1，每次启动生成随机 token， 请求必须带对 token 才执行；token 只经本地文件在桥与 MCP 服务端之间传递。

• 写操作 confirm 闸门：内容级写工具缺 confirm=true 一律拒绝执行； confirm 只能在用户明确同意后填入，Agent 不许自作主张绕过。

• 原件只读：盘点与任何写需求都先 backup、只改副本，原件零写入。

• 不提供任意代码执行工具：Agent 能做的事被限定在可枚举、可审计的 工具集合内，没有 eval/exec 外部输入、任意脚本或任意处理工具调用的通道。

• 能力如实标注：接入方式分模式回报——file-fallback 不冒充实时接入； 无头模式只能读已保存状态；探针未证实的接口不假装存在，返回结构化错误 并附现场线索。

• 先校准后使用：每个包自带校准指南 docs/CALIBRATION.md，给出从探针 钉死接入策略、只读工具逐项对界面、写操作只在副本上验的完整顺序与验收标准。

端口分配

MapGIS、ENVI、Global Mapper、FME 无常驻应用内桥，不占端口。

快速开始

1. 进入你要用的软件对应的子目录。

2. 先读该包的 README.md 与 SKILL.md，弄清它的形态、工具清单与已知边界。

3. 跑该包的探针 / preflight 与 live/selftest.py，确认协议层与本机环境无误。

4. 按该包 docs/CALIBRATION.md 在真实软件上完成实机校准，通过后再正式使用。

客户端接入示例（examples/）

每个包都带一份可直接复制的接入示例，不用对着文字说明手拼配置：

• <包>/examples/mcp-client-config.json：MCP 客户端配置片段，合并进你所用 客户端（Claude Desktop / Cursor / Trae 等）的 mcpServers 段，把占位符 <ABSOLUTE_PATH_TO_PACKAGE> 换成本包在你机器上的绝对路径即可。

• <包>/examples/prompts.md：2–3 条可直接对 Agent 说的提示词示例（只读 盘点、导出、以及一条会触发 confirm 闸的写操作），并写明各自的预期行为。

工具清单的机读版本在 manifest/tools-manifest.json（由 manifest/build_manifest.py 从各包服务端实启探测生成，勿手改）； 安全模型与漏洞报告方式见根目录 SECURITY.md。

状态与诚实声明

各包的校准状态以上方软件矩阵与各包 README 为准，按模式分别认定， 不要一概而论：

• 已完成部分实机校准：SuperMap 无头/文件回退模式（iDesktop 10i(2020)， 13/13 工具，2026-10-24；记录见 supermap/docs/CALIBRATION-RESULTS-20261024.md）； ArcMap 无头桥（Desktop 10.8 / Python 2.7.16，2026-10-25；三项只读＋三项受控写）。

• 仍未实机校准：全部实时（应用内）模式（含 SuperMap iDesktopX 实时、 ArcMap 实时桥），以及 ArcGIS Pro、QGIS、GeoScene、MapGIS、ENVI、 Global Mapper、FME 各包。这些目前只完成了协议层自检（initialize / 工具清单 / 保存闸门 / 错误 token 拒绝）与无头文件层（备份真复制、盘点的 结构化报错等）在无厂商软件环境中的验证。

使用前请先按各包校准指南完成校准——不要把"协议自检通过"理解为 "已与真实软件对接成功"，也不要把一个模式的校准结论套到另一个模式上。

许可与免责

• 本仓库代码以 MIT 许可证发布（见根目录 LICENSE，各子包亦各带一份）。

• 本项目与 SuperMap、Esri、易智瑞、中地数码、NV5、Blue Marble Geographics、 Safe Software 等厂商均无隶属关系，软件名称仅用于指明对接对象。

• 使用各桥需自备对应软件的正版许可；桥本身不包含、不分发任何厂商组件。