br8n
Officialbr8n
Собственная, переносимая рабочая память. Шаблон мозга из простых файлов и крошечный 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 stdioClaude 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 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