返回 MCP 目录
public公开dns本地运行

Obsidian

一个连接Claude Desktop与Markdown笔记目录(如Obsidian库)的协议工具,支持搜索和读取笔记内容。

article

README

🚀 Obsidian 模型上下文协议

这是一个连接器,它能让 Claude Desktop(或其他 MCP 客户端)读取并搜索包含 Markdown 笔记的任意目录,比如 Obsidian 工作区。

🚀 快速开始

本项目是一个允许 Claude Desktop(或其他 MCP 客户端)读取和搜索包含 Markdown 笔记的任何目录(如 Obsidian 工作区)的连接器。

✨ 主要特性

  • 允许 Claude Desktop 或其他 MCP 客户端读取和搜索 Markdown 笔记目录。
  • 支持通过 Smithery 自动安装,也可在 VS Code 中进行快速或手动安装。

📦 安装指南

确保你已经安装了 Claude Desktop 和 npm

通过 Smithery 安装

若要通过 Smithery 自动安装 Obsidian 模型上下文协议,可使用以下命令:

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

安装完成后,重新启动 Claude Desktop,你会看到如下 MCP 工具: image

在 VS Code 中使用

快速安装

你可以使用以下任意一键式安装按钮之一: 在 VS Code 中用 NPX 安装 在 VS Code Insiders 中用 NPX 安装

手动安装

你可以将以下 JSON 块添加到 VS Code 的用户设置 (JSON) 文件中。你可以通过按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。 另外,你也可以选择在工作区的 .vscode/mcp.json 文件中添加它,这样就能与其他用户共享配置。

⚠️ 重要提示

.vscode/mcp.json 文件中不需要 mcp 键。

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端