@brainfeather/mcp

面向 AI 编码代理的长期记忆。事实只需记录一次，所有客户端都能回忆。

你的代理每次会话都从零开始。你反复解释你的技术栈、你的约定、你上周做的决定。Brainfeather 就是负责记忆的那一层，这样它就不必再问一次。

安装

添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "brainfeather": {
      "command": "npx",
      "args": ["-y", "@brainfeather/mcp"],
      "env": {
        "BRAINFEATHER_API_KEY": "bf_live_your_key_here"
      }
    }
  }
}

在 brainfeather.com/settings 生成一个密钥。

配置文件位置：

Related MCP server: arcane

环境

这个密钥是唯一的凭据。它对应一个账户，从仪表盘撤销它会在下一次请求时生效——无需重新部署，没有共享密钥。

更愿意把密钥放在编辑器配置之外？把它们放在 ~/.brainfeather/config.json 中：

{ "apiKey": "bf_live_your_key_here" }

环境变量优先。

工具

六个工具，不是十六个。每个工具描述在每一轮对话中都位于模型的上下文中，所以这个集合刻意保持精简——而且每个描述都说明了何时调用它，因为记忆服务器的失败模式不是工具损坏，而是代理从不调用它。

存储什么

save_memory 可以放心自由调用。服务器决定什么会被保留：

被过滤掉 —— 问候、确认、自言自语、瞬时状态、一次性命令。"早上好"和"让我查一下"永远不会进入存储。

去重 —— 完全重复，以及通过 token 重叠判断的近似重复。保存相同的事实两次会报告 Already known，并且不会改变任何内容。

被取代 —— 与现有事实矛盾的事实会撤回它，而不是与它并存。之后的读取只返回仍然成立的内容，所以你在六月推翻的决定不会在八月重新浮现。

被关联 —— 工具、语言和框架会被自动提取，并连接到提及它们的记忆。无需手动打标签。

回复会告诉你发生了哪种情况：Saved …、Already known … 或 Not stored — <why>。

回复刻意保持简洁

这个服务器返回的所有内容都会进入上下文窗口，所以输出是纯文本行而不是 JSON。三条记忆以美化格式的 JSON 序列化后测得 713 个字符；同样的行以文本行形式测得 131 个字符。

这是字符数，不是 token 数——token 比例取决于分词器，尚未测量。

要求

Node 18 或更高版本（使用全局 fetch）。

链接

• brainfeather.com

• 仪表盘 —— 浏览和编辑记忆

• 问题