Brainstem
Give your AI a second brain.
______________________________________________________________________
您在GitHub回购中维护个人知识库-笔记、文档、参考资料。也许你使用黑曜石、Logseq，或者只是简单的markdown。也许你可以使用Claude Code、ClawdBot、Codex或其他代理来帮助维护它。
脑干 将该仓库连接到您的AI聊天客户端，以便您可以从任何地方搜索和检索自己的知识——您的手机、桌面或任何兼容MCP的工具。
其工作原理如下：
- 你有一个GitHub托管的PKM （个人知识管理）回购，公共或私人
- 您安装Brainstem GitHub应用程序 关于该回购
- Brainstem嵌入您的内容 并在每次推送时保持其索引最新
- Brainstem通过MCP公开搜索和检索工具 您可以连接到任何兼容的AI客户端（Claude Mobile、Claude Desktop、Claude Code等）
就是这样。推送到GitHub，你的人工智能可以在一分钟内搜索到它。
快速开始
1.连接您的存储库
- 访问 brainstem.cc/setup
- 点击 连接存储库 安装GitHub应用程序
- 选择您的存储库
- 从成功页面复制您唯一的MCP端点URL
2.连接您的AI客户端
Claude.ai（网络）——最简单
- 首选 设置→ 连接器→ 添加自定义连接器
- 粘贴您的MCP端点URL：
https://brainstem.cc/mcp/{your-uuid} - Claude.ai通过OAuth自动处理身份验证，无需令牌
克劳德桌面/克劳德代码
添加到您的MCP配置（克劳德桌面： claude_desktop_config.json克劳德代码： .mcp.json 或通过 claude mcp add):
{
"mcpServers": {
"my-brain": {
"url": "https://brainstem.cc/mcp/{your-uuid}"
}
}
}OAuth身份验证是自动处理的——首次使用时，系统会提示您使用GitHub进行授权。不需要手动令牌。
MCP工具
脑干在MCP上展示了八种工具：
| 工具 | 说明 |
|---|---|
search_brain | 在您的知识库中进行语义搜索。结果包括返回GitHub的源代码链接。工具描述动态地反映了您的实际内容域和主题。 |
get_document | 按路径检索文件的完整内容。 |
list_recent | 列出最近修改的文件，可选择按路径前缀过滤。 |
list_folders | 浏览仓库的文件夹结构。 |
brain_inbox | 为你的收件箱写一封便条。在Claude Desktop中，打开一个交互式编辑器，带有实时降价预览、5秒自动保存倒计时和编辑/取消控件。注释同时保存到GitHub和搜索索引中。 |
brain_inbox_save | 将笔记直接保存到收件箱（R2+GitHub）。首选非UI主机和AI代理。 |
brain_account | 管理电子邮件到大脑的转发：验证发件人，索要虚荣别名，检查状态。 |
about | 有关Brainstem实例和可用内容的信息。 |
Sync的工作原理
GitHub Push → Webhook → Brainstem Worker → R2 Storage → AI Search (reindex)
Email → Worker email() handler ↗
Web Clipper → POST /api/clip ↗
Inbox Tools → MCP tool call ↗- 当你推送到连接的仓库时，GitHub会向Brainstem发送一个webhook
- Brainstem通过GitHub API获取更改后的文件，并将其存储在Cloudflare R2中
- Cloudflare AI搜索触发重新索引
- 新内容可在约1分钟内搜索
同步是增量的——每次推送时只获取更改的文件。
省钱的方法
除了同步你的GitHub仓库，还有三个额外的输入路径：
| 方法 | 工作原理 |
|---|---|
| 邮件转发 | 将电子邮件转发到您的 @brainstem.cc 地址。通过设置 brain_account MCP工具。 |
| Web裁剪器 | 浏览器书签小程序提取文章并将其保存到收件箱。从OAuth成功页面获取或 /bookmarklet. |
| 收件箱工具 | 您的AI可以直接通过以下方式保存笔记 brain_inbox （互动作曲家）或 brain_inbox_save （直接保存）。 |
所有保存的内容都会保存在您的 inbox/ 文件夹，一分钟内即可搜索。
建筑
基于Cloudflare的堆栈构建：
- Cloudflare员工 MCP会话状态的持久对象
- Cloudflare R2 的 用于文件存储
- Cloudflare D1 （SQLite）用于安装和用户跟踪
- Cloudflare人工智能搜索 语义搜索与检索
- GitHub应用程序 用于身份验证、webhooks和repo访问
安全与隐私
您的同步文件存储在Cloudflare R2上，使用AES-256-GCM（Cloudflare管理的密钥）进行静态加密，并由Cloudflare AI Search索引以进行语义检索。所有连接都使用TLS。访问您的数据需要通过GitHub OAuth进行身份验证。
租户隔离： 每个安装的数据都存储在唯一的R2前缀下(brains/{uuid}/)搜索查询的范围使用文件夹元数据过滤器。这种隔离已通过多个实时安装进行了验证——从一个安装中搜索、文件列表和文档检索无法访问另一个安装的数据。调试端点强制执行所有权检查。看 积压 查看详细的测试结果。
平台运营商可以出于运营目的对存储的内容进行技术访问。这与大多数SaaS产品的信任模型相同——您信任基础设施提供商（Cloudflare）和平台运营商。不要连接包含机密、凭据或高度敏感数据的存储库，因为您不愿意将这些数据存储在第三方服务上。
通过从存储库设置中卸载GitHub应用程序，您可以随时断开连接并删除所有已同步的数据。卸载会触发自动清理所有存储的文件和搜索索引条目。
有关加密和隔离模型的完整分析，请参阅 ADR-003：静止加密.
文档
许可证
国际学生委员会