首页
/ Obsidian-MCP-Tools安装与配置指南

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

2025-04-17 09:17:30作者:董宙帆

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 应用程序安全地交互。

登录后查看全文
热门项目推荐