mcp-recall-md
Local semantic search for your markdown notes — via MCP.
graph LR
A[".md files
Obsidian · Logseq · plain md"] -- "watch + index" --> B["mcp-recall-md
local vector store"]
C["AI client
Claude · Cursor · Windsurf"] -- "MCP search" --> B
style A fill:#f9f4eb,stroke:#c9a96e,color:#333
style B fill:#e8f0fe,stroke:#4a86c8,color:#333
style C fill:#e8f5e9,stroke:#5b9a5b,color:#333“搜索我关于Kubernetes网络的笔记” → finds kubernetes-networking.md （相似性：0.53）——即使你的措辞与注释不同- 按含义搜索，而不是按关键字搜索 --即使你的措辞不匹配，也能找到笔记
- 100%离线 -没有API密钥，没有云，任何东西都不会离开您的机器
- 零配置 --指向您的文件夹，重新启动AI客户端，完成
- 实时同步 --文件监视器会立即获取更改，只重新嵌入更改的内容
______________________________________________________________________
快速启动
添加到MCP客户端配置并重新启动：
{
"mcpServers": {
"mcp-recall-md": {
"command": "uvx",
"args": ["mcp-recall-md", "--vaults", "C:/Users/you/notes"]
}
}
}配置文件位置：.mcp.json（克劳德密码）·claude_desktop_config.json（克劳德桌面）·光标/风帆MCP设置
就是这样。你的笔记是可搜索的。
______________________________________________________________________
安装
上述快速入门使用 uvx （推荐）。其他选项：
pip
pip install mcp-recall-md{
"mcpServers": {
"mcp-recall-md": {
"command": "mcp-recall-md",
"args": ["--vaults", "C:/Users/you/notes"]
}
}
}Standalone .exe (no Python needed)
- 下载 mcp-recall-md.exe 从 最新版本
- 把它放在一个永久的地方（例如。
C:\Tools\mcp-recall-md\)
{
"mcpServers": {
"mcp-recall-md": {
"command": "C:/Tools/mcp-recall-md/mcp-recall-md.exe",
"args": ["--vaults", "C:/Users/you/notes"]
}
}
}______________________________________________________________________
配置
多个保险库
列出所有文件夹——每个文件夹都有独立的索引：
"args": ["--vaults", "C:/notes/work", "C:/notes/personal", "C:/docs"].recallignore
放下一个 .recallignore 在任何vault根目录中排除文件。标准 .gitignore 语法：
.obsidian/
_templates/
drafts/命令行标志
| 标志 | 默认值 | 描述 |
|---|---|---|
--vaults | *（无）* | 要索引和监视的文件夹 |
--db-path | ~/.mcp-recall-md/db | ChromaDB存储位置 |
--verbose | off | 调试到stderr的日志记录 |
______________________________________________________________________
工具
您的AI助手通过MCP自动获取这些工具：
| 工具 | 说明 |
|---|---|
search | 按含义查找注释--返回具有相似性得分和文件路径的排名结果 |
status | 显示索引文章计数和关注的保管库 |
index | 手动存储物品（无需使用 --vaults) |
remove | 从索引中删除文章 |
大多数用户只与 search --其他一切都是自动的。
______________________________________________________________________
故障排除
| 问题 | 修复 |
|---|---|
| 搜索未返回任何内容 | 请检查 --vaults 指向具有以下内容的文件夹 .md 文件 |
| 首次运行速度较慢 | 首次使用时下载一次嵌入模型（约80 MB） |
| 需要调试 | 添加 --verbose，检查 ~/.mcp-recall-md/server.log |
| 强制重新索引 | 删除 ~/.mcp-recall-md/db 并重新启动 |
日志： ~/.mcp-recall-md/server.log （最大5 MB，3次轮换备份）
______________________________________________________________________
局限性
- 单块嵌入 --大文件（10k+单词）的搜索精度可能不如短笔记
- 英语优化 --其他语言可以工作，但准确性较低
______________________________________________________________________
许可证
麻省理工学院