🧠 Munin Ecosystem for AI Agents
Give your AI Agents a robust, Long-Term Memory.
Have you ever been frustrated when your AI agent forgets the architectural decisions you made yesterday? Or when it repeats the exact same bug it fixed in the previous session?
Munin is a Full-Stack Long-Term Memory manager powered by GraphRAG. This monorepo contains the official Model Context Protocol (MCP) adapters and SDKs to connect Munin Context Cores to your favorite AI tools—allowing them to build, query, and maintain a persistent knowledge graph of your entire project across endless sessions.
✨ Feature Highlights
Munin isn't just a database; it's a cognitive layer for your AI agents:
- 🛡️ AI Memory Guard: Detects semantic contradictions in your agent's memory to ensure consistency.
- 🕸️ GraphRAG Visualizer: Auto-extracts entities and relationships into interactive 2D neural knowledge graphs and Mermaid-compatible diagrams.
- ⚡ Lower Token Costs: Semantic hybrid search (Vector + Keyword) ensures agents pull only the most relevant snippets, keeping prompts lean and fast.
- 🔐 E2EE With GraphRAG: Industry-leading security. Encrypt your memory end-to-end while maintaining the ability to perform high-performance semantic search (Elite Tier).
- 🕒 Temporal Search: Search by time context—ask "what did we decide last Tuesday?" and get exact answers.
- 📌 Dynamic Pinning: Force-inject critical project context (like coding standards or core architecture) so AI never loses the "big picture".
- 🤝 Cross-Project Sharing: Share selected memories across different projects to reuse logic and context without manual copy-pasting.
- ⌛ Memory TTL: Set expiration windows for temporary context to keep your memory cores clean and noise-free.
🔌 Supported Adapters
This ecosystem provides first-class, plug-and-play MCP adapters for the most popular AI development tools. Choose your platform to get started:
- Claude Code (
@kalera/munin-claude) - Cursor & Windsurf (
@kalera/munin-cursor) - Gemini CLI (
@kalera/munin-gemini) - OpenClaw (
@kalera/munin-openclaw) - Kilo (
@kalera/munin-kilo) - Antigravity (
@kalera/munin-antigravity)
📦 Monorepo Structure
This repository is organized as a pnpm workspace containing the core SDKs, the protocol specification, and all individual adapters:
- Protocol Spec:
packages/spec - TypeScript SDK:
packages/ts-sdk - Python SDK:
packages/python-sdk - First-Class Adapters:
adapters/* - Generic MCP Template:
adapters/generic-mcp-template - Contract Test Harness:
tests/contract - Release Tag Mapping:
docs/release-tags.md
🛠️ Developer Guide
If you are contributing to the Munin Ecosystem, use the following commands to manage the monorepo.
Quick Commands
pnpm install
pnpm lint
pnpm build
pnpm test
pnpm test:contract
Contract Test
Start the mock server (default 4010):
pnpm test:contract:mock
If the port is occupied, run on another port:
MUNIN_CONTRACT_PORT=4011 pnpm test:contract:mock
MUNIN_CONTRACT_PORT=4011 pnpm test:contract
You can also override the full base URL directly:
MUNIN_CONTRACT_BASE_URL=http://127.0.0.1:4011 pnpm test:contract
By default, the contract runner uses:
tests/contract/adapter-manifests/munin-sdk-local.json
Override with a custom manifest:
pnpm test:contract -- tests/contract/adapter-manifests/<manifest>.json
Built with ❤️ by Kalera for the AI Engineering community.
