Mneme Decision MCP server

Mneme HQ

<!-- mcp-name: io.github.MnemeHQ/mneme -->

Architectural drift prevention for the agentic AI SDLC.

Mneme turns architectural decisions and ADRs into deterministic guardrails for the agentic AI SDLC — across coding agents, repository mutations, generated rules, and CI gates.

Where is your architecture actually enforced? Run the Architecture Audit to see which decisions are protected, which can become deterministic guardrails, and which still depend on someone remembering the rules. Try it →

Mneme is the architectural governance layer behind that drift-prevention mechanism. It keeps recorded engineering decisions active as AI coding systems propose and modify code, instead of leaving ADRs as passive documentation.

Current phase: Layer 1 validation. Retrieval, enforcement, and benchmark semantics are governed by the accepted architecture and freeze record. See Current Phase before changing core behavior.

What Mneme does

Mneme separates architectural guidance from deterministic enforcement:

• Records architectural decisions in a structured, auditable decision corpus.
• Retrieves relevant decisions when an agent or model needs architectural guidance.
• Enforces governed rules deterministically under explicit applicability semantics.
• Integrates at the earliest reliable boundary exposed by each coding workflow.
• Audits bypassable mutation paths where pre-change blocking is not technically available.
• Runs in CI as a final deterministic gate before incompatible changes are accepted.

The same input and governed decision state produce the same enforcement result. Mneme does not depend on an LLM judge for its core allow/warn/fail decisions.

Mneme is not a general-purpose vector store, conversational memory system, autonomous coding agent, or deployment observability platform.

Install

Requires Python 3.11+.

pip install mneme-hq

Verify the CLI:

mneme --help

For repository development:

git clone https://github.com/MnemeHQ/mneme.git
cd mneme
pip install -e ".[dev]"

Decision MCP

Mneme exposes the Decision Index over a local MCP server so MCP-capable clients can propose candidate architectural decisions and query decision state without gaining authority to change that state.

Install the optional MCP dependency:

pip install "mneme-hq[mcp]"

Start the local stdio server with the proposal store enabled:

mneme decision-mcp

Optionally add a canonical ADR corpus. Mneme validates and precedence-resolves the corpus before the server starts; invalid or ambiguous ADR state fails closed rather than serving a degraded authority view.

mneme decision-mcp --adr-dir path/to/adrs

The MCP surface is intentionally frozen to six tools:

• decision.propose
• decision.propose_batch
• decision.get
• decision.search
• decision.applicable_to
• decision.trace

Proposal tools create non-authoritative proposals only. Read tools query proposal and canonical decision state. MCP deliberately exposes no accept, reject, activate, supersede, exception, bypass, or trusted-evidence authority.

Human authority remains explicit through mneme decision proposals | show | accept | reject. Accepting a proposal materializes a canonical decision; it does not activate protection or run the Architecture Audit.

Shortened. The full README is on GitHub.