Obsidian-MCP-Tools安装与配置指南

1. 项目基础介绍

Obsidian-MCP-Tools 是一个开源项目，它旨在为 Obsidian 用户提供一个通过 Model Context Protocol (MCP) 与 AI 应用程序进行交互的插件。这个项目通过创建一个安全的桥梁，允许 AI 助手在用户允许的情况下读取笔记、执行模板和执行语义搜索等功能，而无需直接访问用户的 vault 文件。

主要编程语言：TypeScript

2. 项目使用的关键技术和框架

• Model Context Protocol (MCP): 一种开放协议，用于标准化 AI 应用程序如何与外部数据源和工具进行交互。
• Obsidian 插件: 用于扩展 Obsidian 功能的插件系统。
• GitHub Actions: 用于自动化构建和发布流程。
• SLSA Provenance: 用于确保二进制文件完整性和来源的技术。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保您的计算机上已安装 Obsidian，版本至少为 v1.7.7。
• 下载并安装 Claude Desktop。
• 安装 Local REST API 插件并获取 API 密钥。
• （推荐）安装 Templater 插件以增强模板功能。
• （推荐）安装 Smart Connections 插件以支持语义搜索。

安装步骤

1. 安装 Obsidian 插件

   • 打开 Obsidian 应用。
   • 转到“设置”>“插件”。
   • 点击“社区插件”标签页。
   • 搜索“Obsidian-MCP-Tools”并点击“安装”。

2. 配置 Claude Desktop

   • 在插件设置中，点击“安装服务器”按钮。
   • 这将自动下载适合您平台的 MCP 服务器二进制文件。
   • 确保您的 Claude Desktop 配置为使用新的 MCP 服务器。

3. 配置插件

   • 安装服务器后，插件将自动使用您的 Local REST API 插件的 API 密钥。
   • 插件还将配置 Claude Desktop 以使用 MCP 服务器，并设置必要的权限和路径。
   • 注意：配置过程需要您的明确许可来安装服务器二进制文件和修改 Claude Desktop 配置。

4. 验证安装

   • 检查插件设置，确认所有必需的插件都已安装。
   • 确认服务器已正确安装。
   • 检查 Claude Desktop 是否已配置。
   • 查看日志以确认没有错误或警告信息。

5. 常见问题

   • 如果服务器无法启动，请确保 Claude Desktop 正在运行。
   • 如果出现连接错误，请验证 Local REST API 插件是否已配置。
   • 如果遇到权限错误，尝试重新安装服务器。

通过以上步骤，您应该能够成功安装和配置 Obsidian-MCP-Tools，并与 AI 应用程序安全地交互。