Skip to main content
Glama

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 就是重点。

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。

无关联

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