br8n
Officialbr8n
Memoria de trabajo propia y portátil. Una plantilla de cerebro en archivos planos y un pequeño servidor MCP que permite que cualquier modelo la lea.
Todo lo que tu equipo ha enseñado a una herramienta de chat sobre cómo se hace el trabajo está dentro del inicio de sesión de otra persona. Cambia de herramienta y vuelves a ser un extraño. Este repositorio es la dirección opuesta: la memoria vive en archivos que posees, y el modelo es solo un lector.
br8n es la práctica de entrega de IA de Branded Mayhem Collective. Esta es la parte abierta: la estructura de archivos y la puerta. La instalación alojada añade recuperación, gobernanza y alguien que lo ejecute contigo — sobre los mismos archivos, que nunca cambian de forma. br8n.io
Qué hay aquí
template/brain/— la estructura del cerebro:how-we-work/,decisions/,exceptions/,handoffs/,voice/. Solo Markdown. Un archivo, una cosa. Escribe el porqué, para que el modelo pueda objetar más tarde.src/— un servidor MCP (stdio) con tres herramientas:brain_list,brain_read,brain_search. La búsqueda devuelve archivo + línea para que las respuestas citen su fuente. Sin vectores, sin índice, sin cuenta. Grep es el punto.
Related MCP server: Universal Memory MCP Server
Úsalo
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 (cualquier cliente MCP) — añade:
{ "mcpServers": { "br8n": { "command": "node", "args": ["/path/to/br8n/dist/cli.js", "/path/to/my-brain"] } } }Luego pregúntale al modelo algo que el cerebro sepa. Responde desde el archivo y lo nombra. Cambia de modelo; misma respuesta, mismo archivo.
Por qué archivos
Portátil.
cp -r brain/ new-machine/es toda la migración. Si no puedes hacer eso, no lo posees.Inspeccionable. Puedes leer cada byte que lee el modelo.
Independiente del modelo. La carpeta no le importa qué modelo está al otro lado de MCP.
Puede objetar. Una decisión almacenada con su porqué permite que un modelo diga «esto entra en conflicto con lo que decidiste en marzo». Un historial de chat no puede.
El método es público a propósito
La estructura y este servidor son MIT. Lo que br8n cobra es por manos en una operación real: extraer lo que realmente hay en las cabezas de las personas, dar forma a la recuperación para el rol, ejecutarlo y mantenerlo actualizado. Si prefieres hacerlo tú mismo, empieza aquí — la mayoría debería. El primer curso gratuito está en br8n.io/lab.
No afiliado
br8n en PyPI (un motor de captura de contexto de otro autor) no es este proyecto.
MIT © 2026 Branded Mayhem Collective LLC
Publicación (mantenedores)
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