ArcGIS Pro MCP

MCP (Model Context Protocol) server สำหรับให้ AI assistant — Claude Code, OpenAI Codex CLI และ Gemini CLI — ควบคุม ArcGIS Pro ที่เปิดอยู่จริง: ดู/จัดการ layer, query ข้อมูล attribute, รันเครื่องมือ geoprocessing, ปรับ symbology, export แผนที่และ layout รวมถึงรันโค้ด arcpy ใดก็ได้

MCP server that lets AI assistants (Claude Code, Codex, Gemini CLI) control a live ArcGIS Pro session through arcpy.

สถาปัตยกรรม

Claude Code / Codex / Gemini CLI
        │  MCP (stdio)
        ▼
arcgis-pro-mcp  (แพ็กเกจนี้ — รันบน Python ≥3.10 ทั่วไป ไม่ต้องมี arcpy)
        │  JSON over TCP (localhost:6510)
        ▼
MCP Bridge  (arcgis_pro_plugin/ — รัน "ภายใน" ArcGIS Pro ผ่าน Python Toolbox
             จึงเข้าถึงโปรเจกต์ที่เปิดอยู่ผ่าน arcpy ได้เต็มรูปแบบ)

ต้องแบ่งเป็น 2 ส่วน เพราะ arcpy จะเข้าถึงโปรเจกต์ที่ เปิดอยู่ ("CURRENT") ได้เฉพาะจาก Python runtime ภายใน ArcGIS Pro เท่านั้น

Related MCP server: ArcGIS Pro Bridge MCP Server

การติดตั้ง

1. ติดตั้ง plugin ฝั่ง ArcGIS Pro

1. เปิด ArcGIS Pro พร้อมโปรเจกต์ของคุณ

2. ไปที่หน้าต่าง Catalog → คลิกขวา Toolboxes → Add Toolbox → เลือกไฟล์ arcgis_pro_plugin/ArcGISMCP.pyt จาก repo นี้

3. รันเครื่องมือ Start MCP Server (พอร์ตเริ่มต้น 6510)

4. เปิด ArcGIS Pro ทิ้งไว้ตลอดการใช้งาน — server จะหยุดเมื่อปิด Pro ดังนั้นเปิด Pro ใหม่เมื่อไหร่ต้องรัน Start MCP Server อีกครั้ง

ทางเลือก (ไม่ใช้ toolbox): วางโค้ดนี้ใน Python window ของ Pro

import sys; sys.path.insert(0, r"D:\Developing\ArcGIS-MCP\arcgis_pro_plugin")
import mcp_bridge; print(mcp_bridge.start_server())

2. ติดตั้ง MCP server

ใช้ Python ≥3.10 ตัวไหนก็ได้ในเครื่อง (ไม่จำเป็นต้องเป็น Python ของ ArcGIS Pro) จากโฟลเดอร์ repo นี้:

pip install -e .

หรือใช้ uv โดยไม่ต้องติดตั้ง — ใช้คำสั่ง uv run --directory D:\Developing\ArcGIS-MCP arcgis-pro-mcp แทนในขั้นตอนถัดไป

3. ลงทะเบียนกับ AI client ที่ใช้

ตัวอย่างด้านล่างใช้ python -m arcgis_pro_mcp ซึ่งใช้ได้เสมอ (ถ้า arcgis-pro-mcp.exe อยู่ใน PATH จะใช้ "command": "arcgis-pro-mcp" เฉย ๆ ก็ได้)

Claude Code — repo นี้มี .mcp.json ให้แล้ว ใช้ได้ทันทีเมื่อเปิด Claude Code ในโฟลเดอร์นี้ หรือลงทะเบียนแบบ global:

claude mcp add arcgis --scope user -- python -m arcgis_pro_mcp

หรือเขียนเองใน .mcp.json (ระดับโปรเจกต์) / ~/.claude.json (ทุกโปรเจกต์):

{
  "mcpServers": {
    "arcgis": {
      "command": "python",
      "args": ["-m", "arcgis_pro_mcp"]
    }
  }
}

OpenAI Codex CLI — เพิ่มใน ~/.codex/config.toml:

[mcp_servers.arcgis]
command = "python"
args = ["-m", "arcgis_pro_mcp"]

Gemini CLI — เพิ่มใน ~/.gemini/settings.json (หรือ .gemini/settings.json ในโปรเจกต์):

{
  "mcpServers": {
    "arcgis": {
      "command": "python",
      "args": ["-m", "arcgis_pro_mcp"]
    }
  }
}

4. ทดสอบ

เปิด ArcGIS Pro + รัน Start MCP Server แล้วลองถาม AI ว่า:

"ping ArcGIS แล้วบอกหน่อยว่าโปรเจกต์ที่เปิดอยู่มี layer อะไรบ้าง"

ตัวแปร environment (ไม่บังคับ)

Tools ทั้งหมด (31 ตัว)

Session / โปรเจกต์

Layer

ข้อมูล attribute

Schema / แก้ไขข้อมูล

Geoprocessing

Symbology / Export

Raster / อื่น ๆ

ตัวอย่าง prompt

• "What layers are in my current map and how many features does each have?"

• "Buffer ชั้นข้อมูลถนน 500 เมตร แล้วเพิ่มผลลัพธ์ลงแผนที่"

• "ลงสีชั้นข้อมูลจังหวัดตาม field POP แบบ graduated 5 คลาส ใช้ color ramp Viridis"

• "export map view เป็น PNG แล้วดูให้หน่อยว่าแผนที่เป็นยังไง"

• "สรุปจำนวน feature แยกตามชนิดป่าใน layer forest_type"

โปรโตคอลภายใน (สำหรับผู้พัฒนา)

Bridge ใช้ newline-delimited JSON ผ่าน TCP:

request : {"id": 1, "command": "get_layers", "params": {"map_name": null}}\n
response: {"id": 1, "success": true, "data": {...}}\n
error   : {"id": 1, "success": false, "error": "...", "traceback": "..."}\n

เพิ่มคำสั่งใหม่ได้โดยเขียนฟังก์ชัน handler ใน mcp_bridge.py + ลงทะเบียนใน HANDLERS แล้วเพิ่ม @mcp.tool() ที่เรียก _call() ใน server.py

ข้อควรระวังด้านความปลอดภัย

• Bridge รับเฉพาะ localhost แต่โปรเซสใดก็ได้ในเครื่องเชื่อมต่อได้ และ execute_arcpy_code / run_geoprocessing_tool แก้ไขหรือลบข้อมูลได้จริง — เปิด server เฉพาะตอนใช้งาน บนเครื่องที่เชื่อถือได้เท่านั้น

• AI ทำงานกับ โปรเจกต์จริงที่เปิดอยู่ — ควร save/backup ก่อนให้แก้ไขข้อมูลจำนวนมาก

แก้ปัญหาเบื้องต้น

โครงสร้าง repo

ArcGIS-MCP/
├── arcgis_pro_plugin/
│   ├── ArcGISMCP.pyt        # Python Toolbox: Start / Stop / Status
│   └── mcp_bridge.py        # socket server + handler 31 คำสั่ง (รันใน Pro)
├── src/arcgis_pro_mcp/
│   ├── server.py            # FastMCP stdio server (31 tools)
│   └── connection.py        # TCP client + auto-reconnect
├── .mcp.json                # config สำเร็จรูปสำหรับ Claude Code
├── pyproject.toml
└── README.md