br8n

br8n

由你拥有、可移植的工作记忆。 一个纯文件大脑模板，以及一个小巧的 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。

使用方法

npx @br8n/mcp ~/my-brain                         # MCP server on stdio (or: npm i -g @br8n/mcp && br8n ~/my-brain)
# template: git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n && cp -r br8n/template/brain ~/my-brain

Claude Desktop / Claude Code / Cursor（任何 MCP 客户端）——添加：

{ "mcpServers": { "br8n": { "command": "npx", "args": ["-y", "@br8n/mcp", "/path/to/my-brain"] } } }

然后向模型询问大脑中已有答案的问题。它会根据文件作答并注明文件名。切换模型，答案不变，文件也不变。

为什么使用文件

• 可移植。 cp -r brain/ new-machine/ 就能完成全部迁移。如果做不到，你就不拥有它。
• 可检查。 模型读取的每个字节，你都能查看。
• 与模型无关。 文件夹不在乎 MCP 的另一端是哪种模型。
• 可以提出质疑。 记录了原因的决策，能让模型指出：“这与您 3 月份做出的决定相矛盾。”聊天记录做不到这一点。

方法有意公开

这个布局和服务采用 MIT 许可证。br8n 收费提供的，是为实际运营提供支持：梳理人们脑海中真正掌握的内容、针对不同角色调整检索方式、运行服务并保持内容更新。如果你更愿意自己动手，就从这里开始——大多数人都应该这样做。免费的入门课程位于 br8n.io/lab。

无关联关系

PyPI 上的 br8n（由另一位作者开发的上下文捕获引擎）不是本项目。

MIT © 2026 Branded Mayhem Collective LLC

发布（维护者）

为 @br8n/mcp 配置一次 npm 可信发布者：

• 发布者：GitHub Actions
• 组织：Branded-Mayhem-Collective-LLC
• 仓库：br8n
• 工作流：publish.yml
• 允许的操作：npm publish

发布已提交到 main 的版本，然后更新官方 MCP Registry：

gh workflow run publish.yml --ref main -f version=0.1.2
gh run watch --exit-status

mcp-publisher login github
mcp-publisher publish

GitHub 托管的工作流使用 npm 可信发布（OIDC），因此不需要长期有效的 npm 令牌。后续发布时请更改版本参数。