Skip to main content
Glama

br8n

Собственная, переносимая рабочая память. Шаблон мозга из простых файлов и крошечный MCP-сервер, который позволяет любой модели читать его.

Всё, чему ваша команда научила чат-инструмент о том, как выполняется работа, хранится внутри чужого логина. Смените инструмент — и вы снова чужак. Этот репозиторий — в другом направлении: память живёт в файлах, которыми вы владеете, а модель — всего лишь читатель.

br8n — это практика AI-доставки Branded Mayhem Collective. Это открытая часть: структура файлов и дверь. Хостинговая установка добавляет поиск, управление и того, кто работает с вами — на тех же файлах, которые никогда не меняют форму. br8n.io

Что здесь

  • template/brain/ — структура мозга: how-we-work/, decisions/, exceptions/, handoffs/, voice/. Только Markdown. Один файл — одна вещь. Пишите почему, чтобы модель могла позже возразить.

  • src/ — MCP-сервер (stdio) с тремя инструментами: brain_list, brain_read, brain_search. Поиск возвращает файл и строку, чтобы ответы цитировали источник. Никаких векторов, индексов, аккаунтов. Grep — вот и вся суть.

Related MCP server: Universal Memory MCP Server

Использование

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 (любой MCP-клиент) — добавьте:

{ "mcpServers": { "br8n": { "command": "node", "args": ["/path/to/br8n/dist/cli.js", "/path/to/my-brain"] } } }

Затем спросите модель о том, что знает мозг. Она отвечает из файла и называет его. Смените модель — тот же ответ, тот же файл.

Почему файлы

  • Переносимость. cp -r brain/ new-machine/ — это вся миграция. Если вы не можете так сделать, значит, вы этим не владеете.

  • Прозрачность. Вы можете прочитать каждый байт, который читает модель.

  • Независимость от модели. Папке всё равно, какая модель находится по ту сторону MCP.

  • Она может возражать. Решение, сохранённое с его почему, позволяет модели сказать: «это противоречит тому, что вы решили в марте». История чата так не может.

Метод публичен намеренно

Структура и этот сервер — под лицензией MIT. За что br8n берёт деньги — это работа с реальной операцией: выявление того, что на самом деле в головах людей, настройка поиска под роль, запуск и поддержание актуальности. Если вы предпочитаете сделать это сами, начните здесь — большинству стоит. Бесплатный первый курс — на br8n.io/lab.

Не аффилирован

br8n на PyPI (движок захвата контекста от другого автора) — не этот проект.

MIT © 2026 Branded Mayhem Collective LLC

Публикация (для сопровождающих)

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