Skip to main content
Glama
CLI-Anything · ArcGIS Pro

CLI-Anything · ArcGIS Pro


The closed-source counterpart to CLI-Anything's QGIS harness. ArcGIS Pro is Esri's commercial GIS desktop app, so it can't be auto-generated from source — this wraps its official ArcPy / ArcGIS Pro SDK instead, in two complementary modes:

✅ Listed in the official CLI-Anything registry (PR #318, merged) and on the Glama MCP registry.

Mode

What it drives

How

Headless CLI

.aprx projects & geodatabases on disk

pip package over arcpy

Live bridge + MCP

the open ArcGIS Pro session (you watch it work)

in-process .NET add-in + MCP server

✨ Features

  • 🗺️ Professional cartography — export layouts and Map Series / map books (ArcGIS Pro's edge over QGIS).

  • 🧰 The whole ArcToolbox — run any geoprocessing tool (buffer, clip, intersect, dissolve, …) via one command.

  • 🔌 Drive the live session — an agent operates the open project over MCP; results appear in the map as you watch.

  • 🤖 Agent-native I/O — every command speaks JSON: { "ok": …, "data" | "error": … }.

  • 🧠 Self-healing install — the CLI re-dispatches into ArcGIS Pro's Python automatically, so it works no matter where it's installed.

  • ✅ Tested — test_core (no backend) + test_full_e2e (needs ArcGIS Pro).

Related MCP server: arcpy-mcp-server

🎬 Demo

A complete workflow driven live by an agent — data → clip → analysis → finished map — inside ArcGIS Pro through the MCP bridge:

🚀 Quickstart

Install into ArcGIS Pro's bundled Python (arcgispro-py3), which provides ArcPy:

"C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" -m pip install ^
  git+https://github.com/Jasper0122/CLI-Anything-Arcgis-Pro.git
cli-anything-arcgis-pro --json info

Installed into a different Python? (e.g. via the CLI-Hub, which uses its own interpreter.) That's fine — the command self-dispatches into ArcGIS Pro's arcgispro-py3 interpreter when ArcPy isn't present. It locates Pro via common install paths, the SOFTWARE\ESRI\ArcGISPro registry key, or the CLI_ANYTHING_ARCGIS_PYTHON environment variable.

Requires a licensed ArcGIS Pro install (provides ArcPy). Verified on ArcGIS Pro 3.4 / ArcPy 3.4.3 / .NET 8.

For the live bridge, build & install the add-in and register the MCP server — see live-bridge/README.md.

🧰 Commands

Headless CLI (every command takes --json before the subcommand):

Command

What it does

info

ArcPy version, license level, extension availability.

project inspect / layers

Maps, layouts, layers, data sources of an .aprx.

layout list / export / mapseries

★ Professional export: layouts + Map Series / map books.

map add-data / symbology graduated / symbology unique

Author the map: add layers, apply graduated-color / unique-value renderers.

data describe / fields / count / query / calc

Inspect & edit feature classes and tables.

gp <tool> -a … --kw k=v

Run any geoprocessing tool (the whole ArcToolbox).

batch export-layouts

Export every layout in a project.

:: print-quality A0 map at 300 DPI
cli-anything-arcgis-pro --json layout export C:\proj\city.aprx --layout "Poster" --out C:\out\poster.pdf --dpi 300

:: buffer roads by 100 m
cli-anything-arcgis-pro --json gp analysis.Buffer -a C:\d.gdb\roads -a C:\d.gdb\roads_buf --kw buffer_distance_or_field="100 Meters"

:: close the loop: add the result to a map and symbolize it — no GUI clicks
cli-anything-arcgis-pro --json map add-data C:\proj\city.aprx C:\d.gdb\tracts
cli-anything-arcgis-pro --json map symbology graduated C:\proj\city.aprx tracts --field MEDINCOME --classes 5 --ramp Viridis

See SKILL.md for the full agent guide, and demos/ for runnable end-to-end demos.

🔌 MCP tools

With the live bridge registered, an agent can drive the open project:

MCP tool

Action on the live project

arcgis_ping

Read the open project: maps, layouts, active view.

arcgis_zoom_to

Zoom the active map to a layer (optionally a selection).

arcgis_query

Query a layer's attributes → structured rows.

arcgis_run_gp

Run any geoprocessing tool; outputs are added to the live map.

arcgis_export_layout

Export a layout to PDF.

🧭 Architecture

Agent ──MCP──► mcp_server.py ──HTTP─► in-Pro add-in ──QueuedTask─► LIVE project
                                                                     (you watch)

ArcPy can't attach to a running ArcGIS Pro from an external process (Esri limitation). The live bridge sidesteps this by running an in-process add-in that exposes the open project over a local socket, wrapped as MCP tools — while the headless CLI stays perfect for batch/automation with no GUI.

Full code-implementation flow:

Implementation flow

Source: docs/implementation-flow.canvas (JSON Canvas / Obsidian).

📁 Repository layout

cli_anything_arcgis_pro/   headless ArcPy CLI (pip package)
tests/                     test_core.py (no backend) + test_full_e2e.py (needs Pro)
demos/                     runnable demos (headless, live bridge, full region workflow)
live-bridge/
  mcp_server.py            stdlib-only MCP server → in-Pro bridge
  ProSimpleMapExport/      ArcGIS Pro .NET add-in (bridge server + export button)
docs/                      hero image, architecture diagram (.png + .canvas)
SKILL.md                   canonical agent skill definition

🤝 Contributing

This is a standalone harness for CLI-Anything (listed in its registry, merged in #318). Issues and PRs welcome — run the tests with ArcGIS Pro's Python:

"C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" -m pytest tests/

Where to help: see the Roadmap — it maps every planned command to its ArcPy / Pro SDK API and marks tasks that need no ArcGIS license (🐍, e.g. the MCP server, tests, docs) and good first issues (🟢). The biggest open frontier is cartographic authoring (symbology, layout, layer management) — the part that makes ArcGIS Pro beat QGIS.

📄 License

Source-available, not OSI open-source. Licensed under the PolyForm Noncommercial License 1.0.0:

  • 🟢 Free for noncommercial use — personal projects, study, research, evaluation, and nonprofit / educational / government organizations.

  • 💼 Commercial use requires a paid license — see LICENSE-COMMERCIAL.md.

This is an independent downstream project; upstream CLI-Anything is separately licensed under Apache-2.0.

🙏 Acknowledgements

Built as a contribution to HKUDS/CLI-Anything — "Making ALL Software Agent-Native." ArcGIS, ArcGIS Pro and ArcPy are trademarks of Esri; this project is an independent integration and is not affiliated with Esri.

Available Tools

6 tools
arcgis_export_layoutA

把活着的 ArcGIS Pro 工程里的某个布局导出为 PDF。导出在用户正开着的 Pro 实例内执行(用户能看到),返回输出路径与文件大小。

Inputs: out (required), layout, dpi.

arcgis_pingA

读取当前打开的 ArcGIS Pro 工程状态:工程名、所有地图、所有布局、以及当前活动的地图/布局。发其它命令前先用它了解打开的是什么工程。

Inputs: no named parameters.

arcgis_queryA

查询活工程里某要素图层的属性,返回结构化的行(不含几何)。可按 where 过滤、限制行数。

Inputs: layer (required), where, map, limit.

arcgis_run_gpA

在活工程上运行任意 ArcGIS 地理处理工具(整个 ArcToolbox:分析/管理/转换/栅格…)。输出图层会自动加到当前地图(用户能看到)。tool 用点号写法如 'analysis.Buffer'、'management.Clip';params 是按工具签名顺序排列的位置参数字符串数组。例:tool='analysis.Buffer',params=['roads','roads_buf','100 Meters']。

Inputs: tool (required), params (required), allow_delete.

arcgis_symbologyA

给活工程里某要素图层套用渲染器,让地图会说话——用户能在 Pro 窗口里立刻看到变色。renderer='graduated' 用数值字段做分级配色(专题图主力);'unique' 用分类字段每个值一种颜色。例:layer='tracts', renderer='graduated', field='MEDINCOME', classes=5, ramp='Viridis'。

Inputs: layer (required), renderer (required), field (required), classes, +3 more.

arcgis_zoom_toA

把活动地图视图缩放到某个要素图层(用户能在窗口里看到地图动)。可选 where 条件:会先选中匹配要素再缩放到选集。需要 Pro 当前处于地图视图(非布局)。

Inputs: layer (required), where.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: status checking, layout export, attribute query, geoprocessing, symbology application, and view zooming. No overlap in functionality.

    Naming Consistency4/5

    All tools start with 'arcgis_' and follow a verb-noun pattern (e.g., arcgis_export_layout, arcgis_zoom_to). Minor abbreviation in 'run_gp' and phrasal verb 'zoom_to' are acceptable but not perfectly uniform.

    Tool Count5/5

    Six tools is well-scoped for interacting with an active ArcGIS Pro session, covering essential operations without being overwhelming or too sparse.

    Completeness3/5

    Covers core workflows like export, query, symbology, and running any geoprocessing tool. Missing direct data editing (create/update/delete features) and layer management, but the GP tool can indirectly cover some gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP-capable assistants to control an open ArcGIS Pro project locally over TCP 127.0.0.1, with 68 commands and 167 tools for layers, editing, symbology, layouts, geoprocessing, and arcpy execution.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to inspect and modify maps and scenes open in a locally running desktop GIS session through natural language, exposing 38 fixed tools for session and layer queries, fields, selection, visibility and renaming, symbology, transparency, camera and elevation, map switching, raster, layout export, whitelisted geoprocessing, and attribute editing. It routes stdio MCP calls through a Windows named pipe to a C# add-in, with no network ports and no arbitrary code execution.
      MIT