前言¶
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 倉庫。