开源项目安装与配置指南：MCP-Obsidian

最新推荐文章于 2025-04-26 18:07:00 发布

凌萍鹃Dillon

最新推荐文章于 2025-04-26 18:07:00 发布

阅读量1k

点赞数 7

本文链接：https://blog.csdn.net/gitblog_00675/article/details/147112108

版权

开源项目安装与配置指南：MCP-Obsidian

mcp-obsidian A connector for Claude Desktop to read and search an Obsidian vault. 项目地址: https://gitcode.com/gh_mirrors/mcp/mcp-obsidian

项目基础介绍

MCP-Obsidian 是一个开源项目，旨在为 Claude Desktop 或任何 MCP 客户端提供一个连接器，使其能够读取和搜索包含 Markdown 笔记的任何目录，例如 Obsidian 文件库。该项目允许用户通过 MCP 协议与 Obsidian vault 交互。

该项目主要使用 JavaScript 语言开发。

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

MCP (Model Context Protocol)：一种允许不同应用程序之间共享上下文的协议。
Smithery：一个自动化安装和配置 MCP 插件的命令行工具。
npm：Node.js 包管理器，用于安装和管理项目的依赖关系。

安装和配置准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

Claude Desktop：MCP 客户端，用于与 MCP 插件交互。
Node.js：JavaScript 运行环境，包括 npm 包管理器。
Git：版本控制工具，用于克隆和更新项目。

详细安装步骤

1. 克隆项目

首先，使用 Git 克隆项目到本地计算机：

git clone https://github.com/smithery-ai/mcp-obsidian.git
cd mcp-obsidian

2. 安装依赖

在项目目录中，使用 npm 安装项目依赖：

npm install

3. 使用 Smithery 安装

为了通过 Smithery 自动安装 MCP-Obsidian 插件，执行以下命令：

npx @smithery/cli install mcp-obsidian --client claude

安装完成后，重启 Claude Desktop，您应该能够看到列出的 MCP 工具。

4. 手动配置 VS Code

如果您希望在 Visual Studio Code 中使用 MCP-Obsidian，您可以进行以下操作：

打开 VS Code。
按下 Ctrl + Shift + P，输入 Preferences: Open User Settings (JSON) 并选择它。
在打开的 settings.json 文件中，添加以下 JSON 配置：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "vaultPath",
        "description": "Path to Obsidian vault"
      }
    ],
    "servers": {
      "obsidian": {
        "command": "npx",
        "args": ["-y", "mcp-obsidian", "${input:vaultPath}"]
      }
    }
  }
}

或者，您可以在工作区的 .vscode/mcp.json 文件中添加上述配置，以便与他人共享配置。

完成以上步骤后，您就可以开始使用 MCP-Obsidian 项目了。如果您在使用过程中遇到任何问题，请查看项目的官方文档或联系项目维护者以获取帮助。

mcp-obsidian A connector for Claude Desktop to read and search an Obsidian vault. 项目地址: https://gitcode.com/gh_mirrors/mcp/mcp-obsidian