Obsidian Model Context Protocol

基本能力

产品定位

mcp-obsidian 是一个用于连接 Claude Desktop 或其他 MCP 客户端与 Obsidian 笔记工具的服务，提供笔记的读取和搜索功能。

核心功能

1. 读取和搜索 Markdown 笔记：支持读取和搜索 Obsidian 保险库中的 Markdown 笔记。
2. 与 Claude Desktop 集成：通过 MCP 协议与 Claude Desktop 无缝集成。
3. VS Code 支持：提供 VS Code 的快速安装和配置选项。

适用场景

1. 笔记管理：适用于需要高效管理和搜索大量 Markdown 笔记的用户。
2. 开发效率：开发者可以通过 VS Code 快速访问和编辑 Obsidian 笔记。
3. 知识管理：适合需要集中管理和检索知识的用户。

工具列表

1. npx @smithery/cli：用于自动安装 mcp-obsidian。
2. VS Code 插件：提供一键安装和配置功能。

常见问题解答

1. 如何安装？：可以通过 Smithery 或 VS Code 进行安装。
2. 如何配置？：需要在 VS Code 的用户设置或工作区配置中添加 JSON 配置块。

使用教程

使用依赖

确保已安装 Claude Desktop 和 npm。

安装教程

通过 Smithery 安装

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

通过 VS Code 安装

1. 使用以下一键安装按钮：
2. VS Code

3. VS Code Insiders

4. 或手动添加以下 JSON 配置到 VS Code 的用户设置或工作区配置中：

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

调试方式

安装完成后，重启 Claude Desktop 并检查 MCP 工具列表是否包含 mcp-obsidian。

许可证

该项目遵循 AGPL-3.0 开源许可条款，请参阅 AGPL-3.0 了解完整条款。