br8n
Officialbr8n
Eigenes, portables Arbeitsgedächtnis. Eine Brain-Vorlage aus einfachen Dateien und ein winziger MCP-Server, der es jedem Modell ermöglicht, sie zu lesen.
Alles, was dein Team einem Chat-Tool darüber beigebracht hat, wie die Arbeit erledigt wird, steckt im Login von jemand anderem. Wenn du das Tool wechselst, bist du wieder ein Fremder. Dieses Repo geht den umgekehrten Weg: Das Gedächtnis lebt in Dateien, die dir gehören, und das Modell ist nur ein Leser.
br8n ist die KI-Delivery-Praxis von Branded Mayhem Collective. Das hier ist der offene Teil: das Dateilayout und die Tür. Die gehostete Installation ergänzt Retrieval, Governance und jemanden, der es mit dir betreibt — auf denselben Dateien, die nie ihre Form ändern. br8n.io
Was es hier gibt
template/brain/— das Brain-Layout:how-we-work/,decisions/,exceptions/,handoffs/,voice/. Nur Markdown. Eine Datei, eine Sache. Schreib das Warum, damit das Modell später widersprechen kann.src/— ein MCP-Server (stdio) mit drei Tools:brain_list,brain_read,brain_search. Die Suche liefert Datei + Zeile, sodass Antworten ihre Quelle zitieren. Keine Vektoren, kein Index, kein Konto. Grep ist der Punkt.
Related MCP server: Universal Memory MCP Server
Verwendung
git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n
cd br8n && npm install && npm run build
cp -r template/brain ~/my-brain # now write in it
node dist/cli.js ~/my-brain # MCP server on stdioClaude Desktop / Claude Code / Cursor (beliebiger MCP-Client) — hinzufügen:
{ "mcpServers": { "br8n": { "command": "node", "args": ["/path/to/br8n/dist/cli.js", "/path/to/my-brain"] } } }Dann frag das Modell etwas, das das Brain weiß. Es antwortet aus der Datei und nennt sie. Wechsle das Modell; dieselbe Antwort, dieselbe Datei.
Warum Dateien
Portabel.
cp -r brain/ new-machine/ist die gesamte Migration. Wenn du das nicht kannst, gehört es dir nicht.Einsehbar. Du kannst jedes Byte lesen, das das Modell liest.
Modell-agnostisch. Dem Ordner ist es egal, welches Modell auf der anderen Seite von MCP sitzt.
Es kann widersprechen. Eine Entscheidung, die mit ihrem Warum gespeichert ist, erlaubt einem Modell zu sagen: „Das widerspricht dem, was du im März entschieden hast." Ein Chatverlauf kann das nicht.
Die Methode ist absichtlich öffentlich
Das Layout und dieser Server sind MIT-lizenziert. Wofür br8n Geld verlangt, ist praktische Arbeit an einem echten Betrieb: herauszufinden, was tatsächlich in den Köpfen der Leute steckt, das Retrieval auf die Rolle zuzuschneiden, es zu betreiben und aktuell zu halten. Wenn du es lieber selbst machst, fang hier an — die meisten sollten das. Der erste Kurs ist kostenlos unter br8n.io/lab.
Nicht verbunden
br8n auf PyPI (eine Context-Capture-Engine von einem anderen Autor) ist nicht dieses Projekt.
MIT © 2026 Branded Mayhem Collective LLC
Veröffentlichung (Maintainer)
npm login && npm publish --access public # 1. claims `br8n` on npm; package.json carries mcpName
mcp-publisher login github # 2. GitHub device-flow auth (org member)
mcp-publisher publish # 3. lists io.github.Branded-Mayhem-Collective-LLC/br8n in the official MCP registryAvailable Tools
3 toolsbrain_listARead-onlyIdempotent
List every markdown file in the brain (relative path, size, last modified).
Inputs: no named parameters.
brain_readARead-onlyIdempotent
Read one file from the brain by relative path (e.g. decisions/2026-03-change-orders.md).
Inputs: path (required).
brain_searchARead-onlyIdempotent
Literal, case-insensitive search across the brain. Returns file, line number and the matching line, so answers can cite the source.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct operation: listing all files, reading a specific file, and searching content. There is no overlap or ambiguity in their purposes.
All tools consistently use the 'brain_' prefix with a simple verb pattern (list/read/search), making the API predictable and easy to navigate.
Three tools is minimal but well-scoped for a read-only markdown knowledge base. Each tool serves a necessary and non-redundant function.
The set fully covers the core retrieval workflows: browsing the structure, reading files, and searching content. Write or management operations are absent, but they appear outside the server's stated read-only scope.
Maintenance
Related MCP Connectors
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Shared long-term memory vault for AI agents with 20 MCP tools.
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
An MCP memory server. One memory your agents share — across models, devices and apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server providing persistent brain storage for LLM agents, including memory, personality, social intelligence, and context management.1MIT
- AlicenseNot gradedqualityDmaintenanceA portable MCP server providing a shared intelligent memory system for any MCP-compatible AI tool, enabling storage, retrieval, extraction, and governance of memories across sessions.MIT
- AlicenseNot gradedqualityDmaintenanceProvides a file-first personal memory layer for AI agents, enabling them to store and retrieve memories as markdown files with an SQLite index. The MCP server offers read-only search by default, with optional write tools for manual memory addition and conflict resolution.2 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server that turns a git-versioned Markdown vault into a queryable memory for AI agents, providing tools like brain_search, brain_read, and brain_neighbors.Apache 2.0