br8n
Officialbr8n
自有、可移植的工作记忆。 一个纯文件的大脑模板,以及一个让任何模型都能读取它的微型 MCP 服务器。
你的团队教给聊天工具的所有关于工作如何完成的内容,都存放在别人的登录账户里。换个工具,你又成了陌生人。这个仓库反其道而行之:记忆存在于你拥有的文件中,而模型只是一个读者。
br8n 是 Branded Mayhem Collective 的 AI 交付实践。这是开放的部分:文件布局和入口。托管安装增加了检索、治理,以及一个与你一起运行它的人——基于相同的文件,这些文件永远不会改变形态。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。
无关联
PyPI 上的 br8n(由另一位作者编写的上下文捕获引擎)不是这个项目。
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