markdown-vault-mcp
活跃·★ 35·MIT·更新于 2026-10-21
这是一个通用的模型上下文协议（MCP）服务器，专为管理Markdown集合而设计，具备全文搜索和语义搜索功能。它允许用户指定一个Markdown文件目录，并通过MCP暴露搜索、读取、写入和编辑工具，支持Obsidian或Zettelkasten等多种笔记库类型。
#Markdown存储库#知识库#全文搜索 (FTS5)#语义搜索#向量搜索#模型上下文协议 (MCP)#AI工具#Git集成
01
功能特性
01全文和语义搜索：结合使用带BM25评分的SQLite FTS5和通过嵌入（FastEmbed、Ollama、OpenAI）进行的语义向量搜索，包括采用倒数排名融合的混合搜索。
02自适应标题级别分块：递归地将长节拆分为更深标题级别的小块，直到每个块符合可配置的词预算，从而提高LLM的检索精度。
03全面笔记库管理：提供前置元数据感知索引、增量重新索引、写入操作（创建、编辑、删除、重命名）以及非Markdown附件支持。
04LLM可见工具和资源：提供超过30个LLM可见的笔记库交互工具（搜索、读取、写入、管理）和9个用于访问笔记库元数据（配置、统计、标签）的资源。
05Git集成和OIDC认证：通过Git集成实现写入时的可选自动提交和推送，并支持OIDC认证以实现安全的HTTP部署。
02
兼容性
Python
运行时
已通过文档验证
Docker
容器
已通过文档验证
Claude Desktop
集成
已通过文档验证
Claude Code Plugin
集成
已通过文档验证
03
快速开始
1
$ pip install markdown-vault-mcp
04
使用场景
↳将URL捕获为笔记：自动抓取、总结网络内容并将其作为结构化笔记保存到笔记库中，同时链接到相关的现有笔记。
↳将主题研究内容纳入笔记库：对某个主题进行深入研究，比较研究结果，并在笔记库中创建一组相互关联的笔记，包括内容地图。
↳提炼日常思考：直接总结并捕获日常对话中的关键见解，将其保存到指定的“收件箱”笔记中，以便后续整理。
↳拆分或合并笔记：通过将单个笔记拆分为多个新笔记，或将内容合并到现有笔记中，有效重构笔记并避免重复。
05
同类工具
评论
登录后发表评论
暂无评论，来发表第一条吧