egeria-mcp 0.4.0

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.4.0

Documentation — Installation, deployment, usage across the API, CLI, and MCP interfaces, and guidance for provisioning the Apache Egeria platform are maintained in the official documentation.

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 populate only the connectors you use; blank connector credentials leave the corresponding harvest inactive.

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.

Additional Deployment Options

egeria-mcp can also run as a local container (Docker / Podman / uv) or be consumed from a remote deployment. The Deployment guide has full, copy-paste mcp_config.json for all four transports — stdio, streamable-http, local container / uv, and remote URL:

• Local container / uv — launch the server from mcp_config.json via uvx, docker run, or podman run, or point at a local streamable-http container by url.
• Remote URL — connect to a server deployed behind Caddy at http://egeria-mcp.arpa/mcp using the "url" key.

Documentation

The complete documentation is published as the official documentation site and is the recommended reference for installation, deployment, and day-to-day operation.

Page	Contents
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	deploy Apache Egeria 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.