Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client