Skip to main content
Glama

br8n

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 stdio

Claude 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 registry

Available Tools

3 tools
brain_listA
Read-onlyIdempotent

List every markdown file in the brain (relative path, size, last modified).

Inputs: no named parameters.

brain_readA
Read-onlyIdempotent

Read one file from the brain by relative path (e.g. decisions/2026-03-change-orders.md).

Inputs: path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools consistently use the 'brain_' prefix with a simple verb pattern (list/read/search), making the API predictable and easy to navigate.

    Tool Count5/5

    Three tools is minimal but well-scoped for a read-only markdown knowledge base. Each tool serves a necessary and non-redundant function.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers