MCP Tools for Obsidian
2025.03.24
100
TypeScript知识库管理AI 集成开发效率
Obsidian-MCP-Tools 是一个为 Obsidian 设计的插件，通过 Model Context Protocol (MCP) 协议，使 AI 应用（如 Claude Desktop）能够安全地访问和操作你的 Obsidian 知识库。该插件包含两部分：一个 Obsidian 插件和一个本地 MCP 服务器，后者作为 AI 应用与知识库之间的安全桥梁。核心功能包括知识库访问、语义搜索和模板集成，所有功能都需要 MCP 兼容的客户端（如 Claude Desktop）才能使用。
View on GitHub
Overview
基本能力
产品定位
Obsidian-MCP-Tools 是一个为 Obsidian 设计的插件，通过 MCP 协议实现 AI 应用与知识库的安全交互。
核心功能
- 知识库访问：允许 AI 助手读取和引用你的笔记，同时保持知识库的安全性。
- 语义搜索：AI 助手可以根据语义和上下文搜索你的知识库，而不仅仅是关键词匹配。
- 模板集成：通过 AI 交互执行 Obsidian 模板，支持动态参数和内容生成。
适用场景
- 使用 AI 助手（如 Claude Desktop）增强 Obsidian 知识库的交互能力。
- 通过语义搜索快速定位知识库中的相关内容。
- 利用 AI 生成动态内容并集成到 Obsidian 模板中。
工具列表
- MCP Server：本地运行的服务器，处理与 AI 应用的通信，确保安全性。
- Obsidian Plugin：为 Obsidian 添加 MCP 功能，与 MCP Server 交互。
常见问题解答
- 服务器无法启动：确保 Claude Desktop 正在运行。
- 连接错误：检查 Local REST API 插件是否已正确配置。
- 权限错误：尝试重新安装服务器。
使用教程
使用依赖
- Obsidian v1.7.7 或更高版本
- Claude Desktop 已安装并配置
- Local REST API 插件已安装并配置 API 密钥
安装教程
- 从 Obsidian 的社区插件中安装该插件。
- 在 Obsidian 设置中启用插件。
- 打开插件设置。
- 点击“Install Server”以下载并配置 MCP 服务器。
调试方式
- 检查插件设置，确保所有必需插件已安装且服务器已正确安装。
- 查看日志文件（通过插件设置中的“Open Logs”选项）。
- 根据日志中的错误信息进行相应调整。