StevenStavrakis/obsidian-mcp

A simple MCP server for Obsidian

解决的问题

允许 AI 助手安全地读取和修改 Obsidian 仓库。作为桥梁,它使基于大语言模型的工具能够在不打开 Obsidian 应用程序的情况下与您的个人知识库进行交互。

工作原理

该项目基于 Model Context Protocol (MCP) 实现了一个本地服务器。它通过直接访问文件系统上的 Markdown 文件来连接 Obsidian 仓库。为确保安全,它使用显式的仓库路径白名单,并严格验证所有文件路径,防止对系统其余部分的未授权访问。它还通过事务系统管理文件更改,记录变更日志,使用 etags 检查冲突,并提供对已删除或修改的笔记的恢复机制。

适用人群

希望将笔记与兼容 MCP 的 AI 助手集成,以实现笔记自动化、搜索和组织的 Obsidian 用户。

主要亮点

  • 事务安全性:文件变更被记录并原子性替换,内置恢复系统可恢复到之前的版本。
  • 全面的工具集:包含读取、创建、编辑、搜索、管理笔记、目录和标签的工具。
  • 智能链接处理:当笔记被移动或重命名时,自动更新维基链接、嵌入和 Markdown 链接。
  • 严格的安全性:阻止符号链接,保留系统目录,并拒绝无效路径,确保 AI 无法访问配置仓库以外的文件。
  • 协议兼容性:兼容现代和旧版 MCP 客户端版本。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目