
安全、本地优先的MCP服务器,通过标准JSON-RPC暴露ArcGIS Pro的ArcPy引擎。
概览
arcgis-mcp-bridge 需要 Windows、授权的 ArcGIS Pro 安装以及 Python 3.11 或更新版本才能使用桥接包。 使用包管理器安装引导包: 然后克隆ArcGIS Pro的Python环境: 如果安装的控制台命令在PATH上可用,arcgis-mcp-setup相当于py -m arcgis_mcp.setup_env。 在 ArcGIS-MCP-Bridge 安装到报告的 ArcGIS-MCP-ENV\python.exe 后,安装才算完成。同时使用该解释器执行 MCP 服务器命令和 ARCPY_PYTHON_PATH。这样可以防止因从其他 Python 环境加载包或本地扩展而导致的工作者失败。 完整的设置和配置请参见。 一个安全、本地优先、异步的 MCP 服务器,通过标准 JSON-RPC 向 Claude Desktop 及其他 MCP 主机开放 ArcGIS Pro 的 ArcPy 引擎。 技术文章:为ArcGIS Pro和ArcPy构建安全MCP桥
概述(AI 翻译)
快速启动
arcgis-mcp-bridge 需要 Windows、授权的 ArcGIS Pro 安装,以及
桥接包使用Python 3.11或更新版本。
使用 one 包管理器安装引导包:
然后克隆ArcGIS Pro的Python环境:
如果已安装的控制台命令在PATH上可用,
arcgis-mcp-setup 等价于 py -m arcgis_mcp.setup_env。
对于安装多个Python的Windows系统非常重要: 设置直到
arcgis-mcp-bridge安装到该 报告了arcgis-mcp-env\python.exe。使用同一个解释器对两个 MCP服务器command和ARCPY_PYTHON_PATH。这防止了工人故障 是因为从另一个Python加载包或本地扩展引起的 环境。
完整设置和配置请参见05 — 安装。
100个声明式地理处理工具。两个独立进程。一个安全层。
一个安全、本地优先、异步的 MCP 服务器,展示了 ArcGIS Pro 的 ArcPy 通过stdio JSON-RPC传输到Claude Desktop和其他MCP主机。
技术文章:为ArcGIS Pro和ArcPy构建安全MCP桥
| 目录 | 100 个工具 ·10 个垂直方向 |
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
arcgis-mcp-bridge
Quick Start
arcgis-mcp-bridge requires Windows, a licensed ArcGIS Pro installation, and
Python 3.11 or newer for the bridge package.
Install the bootstrap package using one package manager:
# Option A — pip
py -m pip install --upgrade arcgis-mcp-bridge
# Option B — uv
uv pip install --upgrade arcgis-mcp-bridge
Then clone ArcGIS Pro’s Python environment:
# The final JSON report contains the target `python_exe` path.
py -m arcgis_mcp.setup_env
If the installed console command is available on PATH,
arcgis-mcp-setup is equivalent to py -m arcgis_mcp.setup_env.
Important for Windows systems with multiple Python installations: the setup is not complete until
arcgis-mcp-bridgeis installed into the reportedarcgis-mcp-env\python.exe. Use that same interpreter for both the MCP servercommandandARCPY_PYTHON_PATH. This prevents worker failures caused by packages or native extensions being loaded from another Python environment.
See 05 — Installation for the complete setup and configuration.
100 declarative geoprocessing tools. Two isolated processes. One security floor.
A secure, local-first, asynchronous MCP server exposing ArcGIS Pro’s ArcPy engine to Claude Desktop and other MCP hosts over stdio JSON-RPC.
Technical write-up: Building a Secure MCP Bridge for ArcGIS Pro and ArcPy
| Catalog | 100 tools · 10 verticals |
| Tests | 86 unit tests · 86/86 passing · arcpy mocked |
| Real runtime evidence | Reproducible ArcGIS Pro MCP smoke benchmark |
| Static analysis | Ruff clean · Mypy strict clean |
| Transport | JSON-RPC 2.0 over stdio |
| License | Apache-2.0 |
Why arcgis-mcp-bridge?
| Feature | arcgis-mcp-bridge | geo2004/MCP-ArcGISPro | nicogis (C#/.NET) |
|---|---|---|---|
| Tools | 100 | ~15 | ~10 |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"arcgis-mcp-bridge": {
"command": "C:\\...\\envs\\arcgis-mcp-env\\python.exe",
"args": [
"-m",
"arcgis_mcp.server"
],
"env": {
"ARCPY_PYTHON_PATH": "C:\\...\\envs\\arcgis-mcp-env\\python.exe",
"ARCGIS_MCP_ALLOWED_ROOTS": "C:\\GIS\\Data;C:\\Workspace",
"ARCGIS_MCP_SCRATCH_GDB": "C:\\GIS\\Data\\scratch.gdb",
"ARCGIS_MCP_MAX_WORKERS": "2"
}
}
}
}