egeria-mcp 0.2.2

Apache Egeria open-metadata API + MCP Server for Agentic AI!

Egeria Mcp

API | MCP Server

Apache Egeria open-metadata API + MCP Server for the agent-utilities ecosystem.

Version: 0.2.2

📖 Full documentation → knuckles-team.github.io/egeria-mcp The polished docs site is the official reference — installation, deployment, usage (API/CLI/MCP), and how to stand up the Egeria platform itself. This README is just the index.

Egeria is federated as the metadata / governance / lineage system-of-record alongside the epistemic-graph Knowledge Graph (the cognition/orchestration plane). This package provides the typed, deterministic Egeria tools a policy router calls, the bottom-up harvest that populates Egeria from the data estate, and the governed_route decision that is the federation delivering value.

Two hard invariants: the KG never becomes the lineage store; Egeria never orchestrates.

What it provides

• EgeriaApi (egeria_mcp.api.api_client_egeria) — a tolerant raw-httpx REST facade over the Egeria View Server (OMVS). No pyegeria runtime dependency (pyegeria's sync wrappers call asyncio.get_event_loop(), which raises on Python 3.14; httpx works on 3.11 and 3.14). It is the injected config["client"] for the KG egeria enrichment extractor and backs all MCP tools. Every call degrades to [] / a clear error rather than raising.
• 21 MCP tools (egeria-mcp console script): granular reads, broad action-dispatch readers across 11 OMVS services, governed_route, the data-store harvest, and write-gated create/classify/lineage tools. See docs/overview.md for the full list and the verified Egeria 6.0 REST contract.

Configuration (environment)

Var	Default	Meaning
EGERIA_PLATFORM_URL	https://localhost:9443	OMAG platform URL
EGERIA_VIEW_SERVER	qs-view-server	View server name
EGERIA_USER	erinoverview	User id
EGERIA_USER_PASSWORD	secret	Password / token
EGERIA_VERIFY_SSL	False	Verify TLS (self-signed homelab)
EGERIA_ENABLE_WRITE	False	Gate every write/harvest tool
EGERIATOOL	True	Register the Egeria tool set

The table above is the required set. The bottom-up harvest connectors (ServiceNow, ERPNext, GitLab, Camunda, Keycloak, Grafana, Portainer, …) each read their own optional credential vars — every variable, grouped by source system with required-vs-optional separation, is documented in .env.example. Copy it to .env and fill in only the connectors you use; blank connector credentials make that harvest a no-op.

Install & run

pip install -e .
egeria-mcp                       # stdio MCP server (default transport)
egeria-mcp --transport http --host 0.0.0.0 --port 8000

Run the bottom-up data-store harvest (needs write enabled):

EGERIA_PLATFORM_URL=https://your-egeria-platform:9443 EGERIA_ENABLE_WRITE=true \
  python -m egeria_mcp.harvest

MCP config

Register in the multiplexer under nickname eg (tools surface as eg__lineage, eg__governed_route, eg__catalog, …). See egeria_mcp/mcp_config.json.

Documentation

The official docs live at knuckles-team.github.io/egeria-mcp — read those rather than the raw docs/ Markdown; they are the same content rendered and searchable.

Page	What's there
Installation	pip, source, extras, prebuilt Docker image
Deployment	run the MCP server, Compose, Caddy + Technitium, env config
Usage	the MCP tools, the EgeriaApi client, the harvest CLI
Backing Platform	stand up Apache Egeria itself with Docker
Overview	tools, REST contract, harvest, federation
Architecture	pipeline, layered client, KG federation diagrams
Concepts	concept registry (CONCEPT:EG-*)

AGENTS.md is the canonical contributor/agent guidance.