内容
# @remember-md/mcp
本地MCP服务器，用于[Remember.md](https://github.com/remember-md/remember)第二大脑。通过`npx`运行，任意MCP客户端均可连接，语义化查询您的markdown大脑。
> **状态：** v0.1.0 — 首个功能性版本。一个工具：`search_brain`。正在积极开发中。
## 功能介绍
将您的本地markdown大脑（一个按照PARA风格组织的`.md`文件目录，由[Remember.md插件](https://github.com/remember-md/remember)管理）暴露为一组MCP工具，任意MCP客户端均可调用 — Claude Code、OpenClaw、Cursor、Codex CLI、Claude.ai网页、ChatGPT自定义GPT等，任何支持模型上下文协议的工具。
v0.1.0中提供的工具：
- `search_brain(query, top_k)` — 混合检索。BM25 + 向量 + RRF融合 + 1跳维基链接扩展。词典优先：BM25结果在第一次运行后立即呈现，向量嵌入在后台构建并在准备就绪后叠加。
计划在v0.2+中提供的工具：
- `get_file(path)` — 读取大脑文件
- `list_recent(period, kind?)` — 最近的日记 / 笔记 / 决策
- `query_persona()` — 当前`Persona.md`内容
- `dashboard_snapshot()` — 计数 + 顶级信念 + 活跃项目
- `propose_belief(claim, evidence)` — 将候选项写入`Inbox/`
## 工作原理
- **存储：** `node:sqlite`（Node 22.5+标准库）+ [sqlite-vec](https://github.com/asg017/sqlite-vec)扩展用于向量搜索 + FTS5用于BM25 — 无服务器，无原生编译，无工具链。
- **嵌入：** [@huggingface/transformers](https://github.com/huggingface/transformers.js)运行量化`Xenova/all-MiniLM-L6-v2`（384d，~23 MB）本地 — 无云调用。
- **同步：** 按需mtime + 内容哈希增量重新索引在查询时进行。大脑（markdown）是真实来源；`.remember/index.db`中的索引可重新构建。
- **优雅降级：** 如果向量加载失败，则回退到仅FTS5；如果两者都失败，则回退到ripgrep。
## 安装
您无需安装。通过`npx`运行：
### Claude Code（通过Remember.md插件的`/remember:init`）
[Remember.md插件](https://github.com/remember-md/remember)自动配置Claude Code的MCP层以启动此服务器。只需运行`/remember:init`。
### Cursor / Codex / 其他MCP客户端
将以下内容添加到您的MCP配置中：
```json
{
"mcpServers": {
"remember": {
"command": "npx",
"args": ["-y", "@remember-md/mcp"],
"env": {
"REMEMBER_BRAIN_PATH": "/绝对路径/到/您的大脑"
}
}
}
}
```
首次运行下载软件包（~15–30秒）和嵌入模型（~23 MB，一次性）。之后，查询时间小于一秒。
## 配置
| 环境变量 | 默认值 | 目的 |
|---|---|---|
| `REMEMBER_BRAIN_PATH` | `~/remember` | 大脑根目录（markdown文件目录） |
| `REMEMBER_INDEX_DIR` | `${brain}/.remember` | SQLite索引存储位置 |
| `REMEMBER_EMBEDDING_MODEL` | `Xenova/all-MiniLM-L6-v2` | Hugging Face模型ID |
| `REMEMBER_TIER` | auto | `auto` / `vec` / `fts5` / `ripgrep`（强制降级层级） |
## 隐私
仅本地使用。无云调用。无遥测。大脑文件夹 + 索引从未离开您的机器。嵌入模型通过ONNX Runtime在进程内运行。
## 许可证
MIT — 请参阅[LICENSE](LICENSE)。
## 相关
- [Remember.md插件](https://github.com/remember-md/remember) — 捕获/策划/角色侧，生成此服务器查询的大脑
- [Remember.md规范](https://remember.md/spec) — markdown标准
