ArcGIS Pro MCP 是一个 ArcGIS Pro 插件，在 ArcGIS Pro 内部实现 Model Context Protocol（MCP），使 AI 助手（Claude、Codex、Antigravity 或其他任意 MCP 客户端）能够直接操作你面前已打开的项目——你的数据、地图和布局，而不是副本或导出文件。
用途
- 用自然语言驱动 ArcGIS Pro 的当前打开项目，覆盖图层、属性、选择、符号系统、布局、栅格、地理处理工具和 arcpy。
- 支持任何助手所支持的语言；插件不依赖英文关键词匹配，非英文文本双向原样传递（例如泰语查询可返回泰语结果）。
主要能力
- 三层请求处理：前两层仅需插件本身；第三层通过 ArcGIS Pro 自带 Python 中的可选 Python 桥接运行，未安装时前两层仍可用。插件未实现的命令会自动转发到该桥接；若桥接未运行，会给出错误及启动方法。
- 共 112 个工具，未列出的功能仍可通过 run_geoprocessing_tool 或 execute_arcpy_code 触达。工具分类包括：会话与项目（14）、属性与编辑（11）、模式与数据集创建（11）、地理处理（7）、符号系统与标注（6）、地图视图与书签（7）、布局与打印（16）、数据查找与检查（6）、逃生通道（4）。标记 ⚠️ 的工具会修改或删除真实数据，🖼️ 表示返回 AI 可查看的图像。
- 内进程架构：插件用 C# 编写，运行在 ArcGIS Pro 自身进程内，直接使用 QueuedTask.Run，比早期全 Python 版本约每次调用 28 秒缩短到 9 毫秒。112 个工具中有三个保留在 Python 侧：execute_arcpy_code（因为编译后的插件无法运行调用时组合的代码）、get_pump_status 和 stop_pump（报告 Python 桥接自身调度器状态）。
安装与使用方式
- 从最新 release 下载两个文件之一：ArcGISProMCP.esriAddinX（双击后由 ArcGIS Pro 自带安装程序处理，重启 Pro 出现 MCP 选项卡）；或 Install-ArcGISProMCP.cmd（自包含单文件，内含插件，双击或从命令提示符运行；用于 Pro 已加载插件但 MCP 选项卡未出现的情况，安装程序会检查并给出修复选项，再次运行可卸载）。
- 要求 ArcGIS Pro 3.7，不需要 Python、SDK 或管理员权限；针对 3.7 构建，无法在更旧版本加载，更新的 Pro 版本应可正常使用。
- 连接 AI 客户端：在 ArcGIS Pro 打开 MCP 选项卡，点击所用助手（最常用的三个在功能区，其余在 More clients 下）。支持 Claude Code、Codex、Antigravity、VS Code、Cursor、Cline、Gemini CLI、Claude Desktop。所有客户端连接的地址为 http://127.0.0.1:6510 。插件还会在 6510 上监听旧版 TCP 桥接，并可选在 6511 上监听 Pro 内 Python 回退，但 AI 客户端均不使用这两个。三个地址都绑定到 127.0.0.1，无法从其他机器访问。
- 多数客户端通过 HTTP 连接；Antigravity 使用 serverUrl 而非 url 且不需要 type；Codex 使用 Streamable HTTP 直接连接（配置文件 ~/.codex/config.toml）。
- Claude Desktop 无法主动连接服务器，只能启动服务器，因此插件会写入一个 PowerShell 桥接 %LOCALAPPDATA%\ArcGIS Pro MCP\stdio-bridge.ps1，将每条消息转发到同一 HTTP 端点并注册 Claude Desktop 运行它。该桥接位于 ArcGIS Pro 内，因此 Pro 必须保持打开，关闭后客户端连接会变红。
- 一键启动/停止按钮：图标显示下次点击的效果，绿色 ▶ 表示已停止，红色 ⏹ 表示运行中。状态显示监听时为绿色广播，未监听时为灰色圆点，并标注 MCP 端口；悬停显示完整地址，点击显示完整报告（已服务请求数、已连接客户端、最后错误）。
适用场景
- 在已打开的 ArcGIS Pro 项目中进行 GIS 操作，包括图层、属性、选择、符号系统、布局、栅格、地理处理与 arcpy 调用。
- 需要助手以自然语言查询和编辑当前项目而非处理副本或导出的情况。
限制与注意事项
- 工具会修改所打开的项目及其底层数据；标记 ⚠️ 的工具会修改或删除真实数据。
- 桥接仅绑定 127.0.0.1，网络无法访问，但任何能在你机器上运行代码的程序都能在 Pro 打开时通过它驱动 ArcGIS Pro；execute_arcpy_code 会以已登录用户权限在 Pro 内执行任意 Python。
- AI 助手输出不确定，且运行前不经审查；建议采用非破坏性步骤、谨慎使用 save_project，并让助手在批量编辑前确认。
- 编辑后若未出现，需调用 save_edits；组内图层在地理处理相关操作中需使用完整名称 "Group\Layer"。
- 无 MCP 选项卡通常由插件安全设置引起，可运行 Install-ArcGISProMCP.cmd 处理。
- 本项目为独立作品，与 Esri 无关联、未获其认可或支持，不是受支持的 ArcGIS 产品；ArcGIS 和 ArcGIS Pro 是 Esri 的商标。
许可与作者
- 作者：Pisut Nakmuenwai（@Knight60）。
- 许可：AGPL-3.0，免费使用、修改与构建，具有互惠条件；商业许可适用于将本作品嵌入不公开源码的产品、托管在闭源服务中或以自己名义再分发。v1.0 及之前版本为 MIT 并保持 MIT，双许可自 v1.1 起适用。
- 软件按“原样”提供，不附带任何明示或暗示的保证。
