内容
# 脑干
**适用于AI代理的本地优先知识后端。**
连接任何MCP主机 — Claude Code、Cursor或您自己的代理托管 — 到一个个人知识引擎：一个与Obsidian兼容的Wiki，具有索引检索、令牌预算的记忆召回和安全摄入。您的代理获得高质量的上下文；您将知识保留在您的机器上。
```
┌────────────┐ MCP（stdio/sse） ┌───────────────────────────────┐
│ 您的代理 │ ◄─────────────────► │ 脑干 │
│ （Claude │ 27种工具 │ · 搜索 + 读取 + 编写Wiki │
│ Code， │ （12种只读） │ · 记忆树召回（BM25 + │
│ Cursor…） │ │ 向量，令牌预算） │
└────────────┘ │ · 代码图谱，覆盖您的仓库 │
│ ·保险库 = 纯Markdown │
└───────────────────────────────┘
```
## 安装
```sh
# 运行而不安装（推荐）
uvx brainstem-mcp init
# 或安装
pip install brainstem-mcp
brainstem init
```
`brainstem init`会在`~/.brainstem/vault`处创建一个保险库（可通过`--root`覆盖），并打印出用于连接您的代理的确切一行代码：
```sh
claude mcp add brainstem -- uvx brainstem-mcp mcp --root ~/.brainstem/vault
```
就这样。不需要API密钥即可提供、搜索和读取 — 您的代理会自带模型。
## Docker
```sh
docker build -t brainstem .
docker run -i -v ~/.brainstem/vault:/vault brainstem # stdio
docker run -p 8765:8765 -v ~/.brainstem/vault:/vault brainstem \
mcp --root /vault --transport sse # sse
```
## 您的代理可以执行的操作
- **搜索和读取** — `search_wiki_index`、`read_wiki_file`、交叉引用、纯Markdown Obsidian兼容保险库中的孤立检测。
- **记忆和召回** — 具有BM25 + 向量搜索和令牌预算的`memory_tree_recall`的分层记忆树，为代理上下文窗口构建。
- **编写知识** — 具有YAML前置信息的结构化页面、索引维护、取代重复。
- **理解代码** — 摄入仓库并查询其架构（`ask_repo`、代码图谱概览/影响）作为代理上下文的一部分。
## 只读配置文件
仅公开12种安全的只读工具（无写入、无发布）：
```sh
brainstem mcp --readonly
```
## 安全立场
脑干将摄入的所有内容视为**不受信任的输入**：摄入的内容不能自行触发写入或发布，并且出站操作仅限于草稿。保险库是您磁盘上的纯Markdown — 无云、无遥测、单租户架构。
## 脑干 vs. OpenWiki
OpenWiki生成文档，代理读取为文件。脑干是一个**实时后端**：您的代理在运行时通过MCP工具查询索引知识库 — 检索、记忆和摄入作为托架的一部分，而不是批处理生成的工件。
## 许可证
MIT
