bitbonsai/mcpvault
A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access
解决的问题
MCPVault 允许 AI 助手直接与本地 Obsidian 库进行交互。它弥合了 AI 客户端与用户个人知识库之间的鸿沟，使 AI 能够读取、搜索和编辑笔记，而无需运行 Obsidian 应用程序或安装任何特定的 Obsidian 插件。
工作原理
它作为本地 Model Context Protocol (MCP) 服务器运行。当 AI 客户端（如 Claude Desktop 或 Cursor）将其作为 stdio 进程启动时，MCPVault 会提供一组工具供 AI 调用以执行文件系统操作。它直接与库中的 Markdown 文件交互，并使用感知 AST 的更新机制，以确保在编辑 frontmatter 时，其他未更改字段的格式得到保留。
适用人群
Obsidian 的用户，希望将其个人笔记和知识库与 AI 代理和 LLM 客户端集成，用于总结研究、管理标签或基于现有笔记起草新内容等任务。
亮点
- 全面的工具集：提供 18 种工具，用于执行包括读取、写入、修补、删除和移动笔记，以及管理标签和 frontmatter 等操作。
- 高级搜索：具备多词匹配和 BM25 重排序功能，以提供更相关的搜索结果。
- 注重安全：实施严格的路径检查，以阻止目录遍历、符号链接转义，以及访问如
.obsidian或.git等敏感文件夹。 - 灵活的写入模式：支持覆盖、追加和前置模式，以便向笔记添加内容。
- 广泛的兼容性：适用于任何兼容 MCP 的客户端，包括 Claude Desktop、ChatGPT Desktop (Enterprise+)、Cursor 和 Windsurf。
相关
- 项目
- 项目
- 项目
- 项目
- 项目