ignition-mcp

A local Streamable HTTP front for ign mcp serve, plus composite workflow tools, ign:// resources, and runbook prompts.

ign is the source of truth: every ign verb is proxied unchanged (the full ign tool catalog, 92 tools in ign 1.4.0), credentials and profiles are ign's, and destructive verbs still require confirm: true. This server never talks to a gateway itself.

Local development only. There is no client authentication. Keep the default loopback bind (127.0.0.1). Do not expose it on a network.

Watch it in use

Ignition MCP + Agent

An agent inspects gateway health, reads batch conditions and traceability, and discusses hold readiness through Ignition MCP.

Open the recordings with playback controls and written summaries. Recorded against a fictional batch process; playback runs at 1.2×.

Related MCP server: ignition-mcp

Requirements

• ign >= 1.4.0 on PATH (or IGN_BIN=/path/to/ign) with a configured profile

• Python 3.11+, uv

Run

uv sync
uv run ign-mcp --profile uat            # http://127.0.0.1:8765/mcp
uv run ign-mcp --stdio                  # same server over stdio

Add to Claude Code:

claude mcp add --transport http ign-http http://127.0.0.1:8765/mcp

Or point a client at the included mcp.example.json.

Settings

Gateway credentials: see ign profile --help (keychain or IGNITION_TOKEN* env).

Upgrading from the previous server

mcp_server.py, run_server.sh, and the Docker image are gone; run uv run ign-mcp. The IGNITION_MCP_* settings are gone too. The gateway URL and credentials now live in ign profile, and the only settings left are the four in the table above.

Run ign adopt --project ign-cli once per gateway to deploy the WebDev routes the tag and script verbs need.

Old tool names map onto ign verbs:

Composite tools

Results: {"ok", "steps": [{tool, ok, code}], ...}; on failure also step and error (the ign envelope).

Resources

ign://status, ign://profiles, ign://projects, ign://rig/status, ign://logs/tail{?n}

Prompts

health_check, bring_up_rig, sync_project(project, profile_a, profile_b), push_local_edits(path), triage_alarm(path)

Develop

uv sync --extra dev
uv run pytest
uv run ruff check . && uv run ruff format --check .

Tests use tests/fake_ign.py; no gateway needed.