前言¶
DeepSeek Harness (DSH) 提供了让模型调用外部工具的能力,但对于地理信息开发者而言,直接连接本机 ArcGIS Pro 通常涉及复杂的 Python 环境配置与进程管理。dsh-arcgis-pro-bridge 插件封装了 ArcGIS-Pro-Bridge-MCP-Server,将 ArcGIS Pro 的 Python 逻辑桥接进 DSH,让模型能通过标准的 MCP 工具名(如 mcp__arcgis__*)直接操作本地 GIS 数据。
这是什么¶
这是由 y0urday 维护的一个 DSH 插件。它通过 DSH 官方的 @deepseek-ai/dsh-mcp-client 以 stdio 方式拉起 Python 服务,并利用 ArcGIS Pro 自带的 Python 子进程执行 ArcPy 逻辑。插件纯 ESM JavaScript + vendored Python,无构建步骤,支持 GitHub 直装与 npm 安装。
核心功能¶
- 结构读取:读取当前工程、图层列表、GDB 结构。
- 空间分析:执行 Buffer、Clip 等基础工具。
- 代码执行:支持执行自定义 ArcPy 代码。
- 工具暴露:所有能力以
mcp__arcgis__*格式暴露给模型。
安装与启用¶
推荐通过 GitHub 直接安装指定版本,避免构建权限问题:
dsh plugin --profile web add github:y0urday/dsh-arcgis-pro-bridge#<commit-sha>
安装后,在配置中应能看到 arcgis-pro-bridge 字段。验证配置并完全重启 dsh web:
dsh --profile web --dump-config
典型用法¶
插件加载后,模型可调用以下工具:
- 连通性测试:调用
mcp__arcgis__ping确认链路,随后调用mcp__arcgis__health_check与mcp__arcgis__doctor,确认 ArcGIS Pro Python 与 ArcPy 可正常导入。 - 数据读取:调用
mcp__arcgis__list_gis_layers读取当前工程,或调用mcp__arcgis__inspect_gdb查看数据库结构。 - 空间处理:调用
mcp__arcgis__buffer_features或mcp__arcgis__clip_features进行分析。 - 自定义代码:调用
mcp__arcgis__execute_arcpy_code执行任意 ArcPy 逻辑。
适用场景与注意¶
- 环境要求:仅支持 Windows,需预先安装 ArcGIS Pro。DSH 版本建议使用 0.1.0-rc.6 以上,Node.js >= 22.19。推荐安装
uv或使用已装mcp包的 Python 3.11+。 - 运行机制:服务仅限本机运行,不开放网络端口。ArcPy 永远在 ArcGIS Pro 自带 Python 中执行,不污染 Node 环境。
- 资源限制:官方 MCP 桥目前只桥接 Tools,上游的
arcgis://Resources 不会被注册,读取操作请使用同名 Tool(如inspect_gdb)。 - 安全提示:
execute_arcpy_code等同于在本机执行代码,请仅在可信机器上启用,写操作前务必备份数据。
短结尾¶
该插件通过封装 MCP Server,降低了在 DSH 中使用 ArcGIS Pro 的门槛。适合需要将 GIS 分析能力嵌入智能体工作流,且环境为 Windows 的开发者。完整源码与目录可参考 GitHub 仓库。