ArcGIS Pro Bridge MCP Server
ArcGIS Pro Bridge MCP Server 是一个给 ArcGIS Pro 用的本地 MCP Server。
它的作用可以直接理解成：
- 让 Trae、Cursor、Claude Desktop 这类支持 MCP 的 AI 客户端，能够读取你本机的 ArcGIS Pro 工程信息
- 让 AI 能在 ArcGIS Pro 自带的 Python 环境中执行 ArcPy
- 尽量减少 GISer 手动折腾 Python 环境的成本
这个项目不是 ArcGIS Pro 插件，也不是双击就能打开的桌面软件。它更像一个“后台桥接服务”，由 AI 客户端按 MCP 方式调用。
它适合做什么
当前版本适合这些场景：
- 读取当前 ArcGIS Pro 工程中的地图和图层
- 检查哪些图层的数据源已经断开
- 读取
.aprx 工程中的布局、地图框和默认地图候选
- 读取
.gdb 的要素类、字段和空间参考
- 让 AI 生成 ArcPy 脚本
- 让 AI 执行 Buffer、Clip、Merge 等 ArcPy 地理处理
它不适合做什么
当前版本不适合直接用于这些场景：
- 对公网开放的远程 GIS 服务
- 无人值守地直接修改生产数据
- 替代 ArcGIS Pro 图形界面
- 当作通用文件管理工具浏览任意本地目录
它的定位是“本机上的 ArcGIS Pro AI 桥接工具”，不是通用桌面助手。
使用前需要准备什么
请先确认：
- 你使用的是 Windows
- 你的电脑已经安装 ArcGIS Pro
- ArcGIS Pro 可以正常启动
- 你的电脑中有 Python 3.11 或更高版本
- 建议安装
uv
最容易误解的地方
这是最重要的一节。
1. MCP 配置里的 JSON 不是命令行命令
README 或 examples/ 目录里提供的 JSON 配置，不是复制到 PowerShell 或 CMD 里直接运行的。
这些 JSON 的正确用途是：
- 粘贴到 Trae 的 MCP 配置界面
- 或写入 Cursor / Claude Desktop 的 MCP 配置文件
如果你把 JSON 直接复制到命令行里运行，是不会按预期工作的。
2. uv run arcgis_mcp_server.py 不是给你长期手动测试 stdout 用的
这条命令的作用是启动一个 stdio 型 MCP Server。
它启动后会一直等待客户端请求，这是正常现象，不是卡死。
正常使用时，一般应由 Trae、Cursor、Claude Desktop 自动拉起它，而不是你手动先开一个终端，再自己写测试脚本去读 stdout。
3. 这个项目主要是 ArcGIS MCP，不是文件系统 MCP
它擅长的问题是：
- ArcGIS 环境是否发现成功
.aprx 工程里有什么.gdb 里有什么- ArcPy 能不能执行
它不适合用来回答：
- 当前项目目录里有什么文件
- 帮我列出任意本地目录结构
这类需求更适合 shell 或单独的文件系统 MCP。
正确使用流程
建议按下面顺序使用：
- 获取项目并进入项目目录
- 运行
uv sync
- 把 MCP 配置 JSON 填到 Trae / Cursor / Claude Desktop 的 MCP 配置里
- 重启客户端，或刷新 MCP Server 列表
- 在聊天中直接让 AI 调用 MCP Tool
不推荐的错误流程
这些做法很容易导致“看起来卡住”：
- 把 MCP 配置 JSON 当成命令行命令去运行
- 手动启动
uv run arcgis_mcp_server.py 后，再自己写 Python 脚本去测试 stdout
- 明明要测试 ArcGIS MCP，却问“当前目录下有哪些文件”
- 没有明确要求 AI 使用 MCP，结果它自己转去走 shell
快速开始
第一步：安装依赖
进入项目目录后，运行 uv sync。
注意：
arcpy 不会通过 uv 安装arcpy 来自 ArcGIS Pro 自带环境- 本项目会在运行时自动寻找它
第二步：把 MCP 配置加到客户端
具体可复制配置请看：
第三步：重启客户端
无论是 Trae、Cursor 还是 Claude Desktop，配置完成后都建议完全重启一次。
第四步：先做最简单的测试
第一次不要直接让 AI 做复杂分析。
建议先让它只调用：
确认 MCP 调用链路和 ArcPy 运行时都正常后，再继续读取工程、GDB 或执行地理处理。
如何接入 Trae
Trae 里最关键的是要理解：
正确做法
- 打开 Trae 的 MCP 配置页面
- 新增一个本地 MCP Server
- 把示例 JSON 粘贴到 MCP 配置区域
- 保存配置
- 重启 Trae，或者刷新 MCP 列表
可参考：
如果你的 Trae 已经显示服务名称，并且旁边是绿色勾，通常说明：
- 配置格式基本正确
- Trae 能识别这个 MCP Server
但这还不代表当前这次对话一定已经真正调用了 MCP Tool。
如何接入 Cursor
Cursor 的思路和 Trae 类似，也是把 MCP 配置写入它的 MCP 配置位置，而不是复制到终端。
建议做法：
- 打开 Cursor 的 MCP 配置入口
- 新增一个本地
stdio MCP Server
- 填入示例 JSON
- 保存并重启 Cursor，或刷新工具列表
可参考：
如何接入 Claude Desktop
Claude Desktop 一般也是通过 MCP 配置文件接入。
建议做法：
- 找到 Claude Desktop 的 MCP 配置文件
- 把示例 JSON 加到
mcpServers
- 保存文件
- 完全退出 Claude Desktop
- 重新打开 Claude Desktop
可参考：
第一次使用时建议怎么问
第一次测试，建议问题尽量简单、尽量像 ArcGIS 问题，而不是“帮我测试 server”。
推荐顺序：
- 先调用
ping，确认这次请求真的走到了 MCP Tool
- 再调用
health_check 或 doctor，确认 ArcGIS Pro Python 和 ArcPy 运行时
- 再读取当前工程图层
- 再读取指定 GDB 或
.aprx 工程概览
- 最后再执行
buffer_features、clip_features 或通用 execute_arcpy_code
更多可直接复制的中文提示词见：
如何判断 AI 是否真的调用了 MCP
这也是非常关键的一节。
如果 AI 真正调用了 MCP
通常会出现这些特征：
- 直接返回
ping、health_check、doctor、inspect_gdb、inspect_project_context 等结果
- 结果内容明显是 ArcGIS 结构化信息
- 不会自己去写测试脚本
- 不会要求你手动长期开着一个 server 窗口读 stdout
如果 AI 没有真正调用 MCP
通常会出现这些特征：
- 它开始自己写
test_mcp_server.py、inspect_gdb.py 之类的脚本
- 它在终端里手动运行
uv run arcgis_mcp_server.py
- 它尝试自己解析 stdout
- 过程看起来“卡住很久”
如果出现这些现象，通常不是 ArcGIS 真的慢，而是它没有按 MCP 协议去使用这个服务。
推荐给 Trae 的测试提示词
如果你
... View full README on GitHub
