akatsuki
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π Akatsuki (ζ)
High-Performance Native Rust CLI and Model Context Protocol (MCP) Knowledge Secretariat for Living System Memory, Architectural Contracts, and Multi-Agent Orchestration.
ποΈ What is Akatsuki?
As AI coding swarms and autonomous agents (Antigravity, Claude Code, pi, OpenCode, Cursor) write and refactor code, traditional static documentation decays. Infrastructure configurations drift, network ports clash, and architectural boundaries get silently breached.
Akatsuki solves this by providing a Living Systems Memory Substrate:
Dual-Layer Architecture: Pure Markdown Git repository as the immutable source of truth paired with an ephemeral, high-speed SQLite WAL projection (
.akatsuki/cache.db) synced via parallel Blake3 content hashing (Rayon).Machine-Verifiable Contracts: Inspect living system contracts, service boundaries, and cluster topology (
akatsuki contract <note>) using 70β90% fewer tokens than raw document reads.Living Invariant Testing (
bash:verify): Execute machine-verifiable infrastructure assertions (ports, containers, daemons) embedded in Markdown notes with process group isolation, execution timeouts, and security sanitization.Hybrid Search (BM25 + Semantic Vectors): Fuses SQLite FTS5 Okapi BM25 with pure-Rust Candle embeddings (
intfloat/multilingual-e5-small, 384D) via Reciprocal Rank Fusion (RRF, $k=60$).Native Dual-Interface (CLI + MCP): Operate seamlessly from the human terminal (
akatsuki <command>) or equip autonomous agents directly through native JSON-RPC 2.0 stdio (akatsuki mcp).Resilient MCP Engine: 20 specialized architectural tools with panic isolation (
catch_unwind), type coercion (arg_bool,arg_usize), and parameter aliasing.
Related MCP server: cog-brain
π Quick Start
1. Installation
Option A: Standard Installation (Pure Lexical BM25, Zero ML Overhead) Compiles with native SQLite FTS5 lexical ranking, instant sub-millisecond startup:
cargo install --path .Option B: With Semantic Vector Embeddings & Hybrid RRF Search Compiles with the pure-Rust Candle tensor engine for local offline semantic embeddings:
# Build and install with vector features
cargo install --path . --features vectors
# Download the multilingual-e5-small model weights into ~/.cache/akatsuki/models/
akatsuki setup-models2. Living Memory Vault Structure
Akatsuki operates on structured knowledge vaults:
knowledge-base/
βββ .akatsuki/ # Derived SQLite projection and locks (gitignored, auto-rebuilt)
βββ .gitignore # Multi-machine ignore rules
βββ AGENTS.md # Master architectural protocol and invariants
βββ INDEX.md # Auto-maintained catalog and domain index
βββ 01-Daily/ # Daily activity ledgers & worklogs
βββ 20-Projects/ # Active software project architectures
βββ 40-Systems/ # Host specifications, topologies & ADRs
βββ _templates/ # Note, system, and daily templates3. Basic CLI Commands
# Hybrid Search (Okapi BM25 + Dense Semantic Vectors via RRF, k=60)
akatsuki search "docker swarm routing" --mode hybrid --with-graph
# Pure lexical BM25 search
akatsuki search "docker swarm routing" --mode bm25
# Pure semantic vector search (errors explicitly if weights are absent)
akatsuki search "hardware specifications of primary host" --mode vector
# Machine boundary contract extraction (ports, invariants, relations, dependents)
akatsuki contract 40-Systems/Cluster-Topology.md
# Token-budgeted surgical note read
akatsuki read "Cluster-Topology" --section "Private Network Routing" --budget 500
# Graph traversal and dependency blast radius
akatsuki map auth-service --depth 2 --direction both
akatsuki blast auth-service
# Run living invariant checks across system documentation
akatsuki test
# Record an outbound telegraphic caveman ledger entry (<= 280 chars)
akatsuki log --project "web" --summary "migrate edge certs -> renew wildcard SAN; exit 0"
# Surgically update frontmatter without corrupting note bodies
akatsuki set "20-Projects/filament" --key status --value "live"
# Verify vault integrity (wikilinks, orphans, MOC reachability) and lint YAML
akatsuki verify
akatsuki lint
# Synchronize SQLite projection with vault disk state
akatsuki reconcileπ€ MCP Server Setup (for AI Agents)
Akatsuki runs as a native stdio Model Context Protocol (MCP) server exposing 20 specialized architectural tools:
akatsuki mcp [--vault <dir>]Configuration Snippets
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"akatsuki": {
"command": "akatsuki",
"args": ["mcp"],
"env": {
"AKATSUKI_VAULT": "/path/to/your/knowledge-base"
}
}
}
}Cursor (.cursor/mcp.json)
{
"mcpServers": {
"akatsuki": {
"command": "akatsuki",
"args": ["mcp"]
}
}
}Antigravity (~/.gemini/antigravity-cli/mcp/) / OpenCode / pi
{
"mcpServers": {
"akatsuki": {
"command": "akatsuki",
"args": ["mcp"]
}
}
}π οΈ Complete MCP Tools Reference (20 Tools)
MCP Tool | CLI Equivalent | Key Arguments | Description |
|
|
| Fast hybrid/BM25 search with contextual snippets and optional graph context. |
|
|
| Read full notes or extract individual headings with token budget packing. |
|
|
| Extract machine boundary contracts (APIs, ports, schemas, invariants). |
|
|
| Compute upstream callers and downstream dependencies for blast radius analysis. |
|
|
| Hierarchical knowledge graph traversal ( |
|
| (none) | Read active service matrices, container prefixes, and port allocations. |
|
| (none) | List all tracked software repositories and production deployment statuses. |
|
|
| Append telegraphic ledger entries to today's active worklog under kernel lock. |
|
|
| Create or replace vault notes with auto-completed frontmatter. |
|
|
| $O(1)$ exact metadata lookup across frontmatter and projection tables. |
|
|
| Read-only SQL queries ( |
|
|
| Surgically update YAML frontmatter keys with JSON/primitive typed values. |
|
|
| Surgically replace section contents while preserving the heading line. |
|
|
| Append markdown bullets or text under a specific heading. |
|
|
| Read today's or specified daily horizon and work ledger. |
|
| (none) | Validate vault notes against strict YAML schemas and boundary rules. |
|
| (none) | Verify bidirectional wikilink closure, markdown links, and MOC reachability. |
|
|
| Execute machine-verifiable |
|
|
| Rebuild SQLite projection, auto-quote colon scalars, and sync vectors. |
|
|
| List notes in the vault with metadata, status, and domain filtering. |
β‘ Vault Discovery Ladder
Akatsuki locates the target knowledge base automatically using a multi-tiered resolution ladder:
CLI Flag:
--vault /path/to/vault(or-V)Environment Variable:
AKATSUKI_VAULT=/path/to/vaultUpward Directory Walk: Traverses upwards looking for
.akatsuki/orINDEX.md+AGENTS.md.Well-Known Locations: Checks
~/configs/knowledge-base/akatsuki,~/.akatsuki,~/akatsuki.Fallback: Current working directory.
π§ͺ Testing
Akatsuki is validated against an exhaustive regression and integration test suite:
# Run complete test suite (unit, CLI, and regression tests)
cargo test
# Run tests with output
cargo test -- --nocaptureThe test harness asserts:
Path traversal underflow containment and internal
.akatsuki/mutation isolation.Read-only SQLite query validation and mutating CTE / SQL injection prevention.
Security gate blocking destructive invariant commands (
rm,dd,mkfs, fork bombs).Invariant timeout handling and asynchronous output buffer draining (capped at 2 MB).
Wikilink code fence stripping and heading extraction with emoji/punctuation normalization.
Token sequence clamping (512 tokens) to protect BERT positional embeddings.
π License
MIT License. Copyright (c) 2026 Yusuf AkΓ§akaya.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Your personal library, readable by AI agents: durable snapshots, hybrid search, 46 MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceExposes repo-native, self-verifying memory to coding agents over stdio MCP, letting them recall ranked past decisions, record new claims with verifiable receipts, and check the health and stats of stored memory. Keeps agent context honest by surfacing memories whose evidence no longer holds.1 npmMIT
- AlicenseAqualityBmaintenanceTurns a plain-Markdown Obsidian vault into a second brain that any MCP-speaking coding agent can search, read, extend, and maintain, using swappable SQLite, Qdrant, or markdown memory backends with automatic re-indexing and wiki-link graph navigation. Exposes read, write, and index tools plus an operator CLI for health, linting, and graph export.12MIT
- AlicenseAqualityAmaintenanceLets AI agents query, search and read wiki pages and raw transcripts of past coding sessions, so they can look up prior decisions and fixes before redoing work. It also exposes linting, sync, export and dashboard tools over stdio, with path-traversal guards and no SDK dependency.15441 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceExposes a Markdown vault as long-term memory for MCP-compatible LLM clients, letting agents search, read, create, update, and delete notes, manage core persona and persistent directives, append to daily logs, and inspect backlinks, tags, and the link graph. It runs locally over stdio against a chosen vault directory.MIT