arcpy-mcp-server -- AI + GIS Smart Spatial Analysis

Let LLMs (GPT-4o, Claude, DeepSeek) directly operate ArcGIS Pro -- drive 1300+ spatial analysis tools with natural language.

What is this?

arcpy-mcp-server exposes all ArcGIS Pro toolboxes as MCP (Model Context Protocol) tools, enabling:

You: "Buffer analysis 500m around the university"
AI: Auto-calls arcpy -> ArcGIS Pro -> generates result

No tool names to memorize. No Python to write. No menus to click.

Related MCP server: yellow-pages

Features

• 2500+ tools across 46 toolboxes: management(431), sa(355+), ia(328, Image Analyst), ddd(144), stats(44), ga(39), analysis(38), un/nd/tn (utility network), geoai (deep learning) + 36 more

• MCP standard: works with AutoClaw, Claude Code, Codex, any MCP client

• Zero dependencies: uses ArcGIS Pro's built-in Python 3.9

• Security whitelist: configurable path and tool restrictions

• One-click install: 30 seconds from clone to running

Also available as an Agent Skill 🚀

Prefer a ready-made agent skill (no MCP client configuration needed)? The same 1300+ tools are packaged as ArcGIS Agent — a portable skill with an agent-facing playbook, installable in one command:

• 📦 GitHub repo: https://github.com/zhaojj662/arcgis-agent

• 🧩 Skill registry page: https://clawhub.ai/zhaojj662/skills/arcgis-agent

• ⌨️ Install: clawhub install arcgis-agent

Works with WorkBuddy, OpenClaw, Claude Code and any agent that reads SKILL.md.

Supported Modules

Quick Start

Prerequisites

• Windows 10/11

• ArcGIS Pro 3.x (with valid license)

• Python 3.9+

Install

git clone https://github.com/zhaojj662/arcpy-mcp-server.git
cd arcpy-mcp-server
install.bat

Start Server

Double-click start_server.bat or run:

start_server.bat

Server runs on http://127.0.0.1:8765.

Verify:

Invoke-RestMethod http://127.0.0.1:8765/health
# {"status":"ok","server":"arcpy-mcp-server","version":"2.1","tools":2500,"modules":46}

Configure AI Client

AutoClaw MCP Settings:

Claude Code (claude_desktop_config.json):

{
  "mcpServers": {
    "arcpy": {
      "command": "python",
      "args": ["C:/Users/%USERNAME%/arcpy-mcp-server/mcp_bridge.py"]
    }
  }
}

Try It

"Buffer roads.shp by 500 meters"
"Calculate slope and aspect from this DEM"
"Hotspot analysis on crime points"
"Kriging interpolation on PM2.5 monitoring data"
"Batch viewshed for 100 observer points"

Architecture

AI Client <-- stdio --> mcp_bridge.py <-- HTTP --> server.py (arcpy) --> ArcGIS Pro 3.x

Security

Edit server.py to restrict access:

ALLOWED_PATHS = ["C:/GIS-AI-Course/"]  # Only allow these directories
INCLUDE_MODULES = ["analysis", "sa"]   # Only expose these modules

API

FAQ

Q: Is ArcGIS Pro required? A: Yes. arcpy runs only inside the ArcGIS Pro Python environment.

Q: Supported ArcGIS Pro versions? A: 3.x series (tested on 3.0).

Q: Can I limit which tools AI can access? A: Yes. Edit INCLUDE_MODULES in server.py.

License

MIT -- see LICENSE