AI导哈

Markdown语义搜索工具

一款基于MCP协议的本地Markdown语义搜索工具，能够通过语义而非关键词搜索笔记内容，支持实时同步和离线使用。

  • by kalikin-artem
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kalikin-artem/mcp-recall-md

使用说明

mcp-recall-md

Local semantic search for your markdown notes — via MCP. 


graph LR
    A["<b>.md files</b><br><i>Obsidian · Logseq · plain md</i>"] -- "watch + index" --> B["<b>mcp-recall-md</b><br><i>local vector store</i>"]
    C["<b>AI client</b><br><i>Claude · Cursor · Windsurf</i>"] -- "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)
  1. 下载 mcp-recall-md.exe 从 最新版本
  2. 把它放在一个永久的地方（例如。 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+单词）的搜索精度可能不如短笔记
  • 英语优化 --其他语言可以工作，但准确性较低

许可证

麻省理工学院

相关 MCP