MCP Obsidian

MCP Obsidian 是一个基于 Model Context Protocol (MCP) 的服务器工具，通过 Obsidian 的 Local REST API 插件与 Obsidian 知识库进行交互。该工具允许用户通过自然语言指令操作 Obsidian 中的笔记内容，包括文件管理、内容获取、智能搜索、内容编辑等，实现 AI 与 Obsidian 的无缝集成，提升知识管理效率。

核心功能

MCP Obsidian 提供了多种工具来操作和管理 Obsidian 中的文件，包括：

• 文件列表浏览：列出知识库中的文件和目录结构。
• 内容获取：读取指定笔记的完整内容。
• 智能搜索：通过自然语言搜索相关笔记。
• 内容编辑：在指定位置插入或追加内容。
• 文件管理：创建、删除文件和目录。

这些功能使得用户可以通过 AI 指令快速查找、总结、整理和编辑笔记内容，适用于会议记录摘要、技术文档分析、知识图谱构建等场景。

安装方法

要使用 MCP Obsidian，首先需要在 Obsidian 中安装并启用 Local REST API 插件，然后配置 API 密钥。

在 Obsidian 中，可以通过社区插件市场搜索并安装该插件。安装完成后，在插件设置中复制 API 密钥。

接下来，需要在 Claude 的配置文件中添加 MCP Obsidian 服务器的配置信息。以下是两种配置方式：

开发/未发布的服务器配置

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "/mcp-obsidian",
        "run",
        "mcp-obsidian"
      ]
    }
  }
}

已发布的服务器配置

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY" : ""
      }
    }
  }
}

此外，也可以在工作目录中创建一个 .env 文件，包含以下变量：

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

使用方法

MCP Obsidian 提供了多种命令来操作 Obsidian 知识库，以下是几个常用命令及其使用示例：

列出知识库中的所有文件

list_files_in_vault

搜索笔记内容

search("Azure CosmosDb")

追加内容到笔记

append_content({
  "filePath": "summary.md",
  "content": "这是追加的内容。"
})

删除文件

delete_file("summary.md")

用户可以通过自然语言指令与 AI 交互，例如：

• “总结上周所有会议记录并创建摘要文件”
• “查找所有提到 React 的笔记并列出关键概念”
• “收集所有关于项目计划的笔记到 project-plan.md”

使用场景

MCP Obsidian 适用于需要 AI 辅助处理大量笔记内容的场景，包括：

• 会议记录摘要：自动总结会议内容并生成摘要文件。
• 技术研究：查找特定技术相关的所有笔记并提取关键概念。
• 内容整理：将分散的笔记内容整理到统一文档中。

注意事项

在使用 MCP Obsidian 时，需要注意以下几点：

• 确保 Obsidian 的 Local REST API 插件已正确安装并启用。
• 配置 API 密钥时，确保密钥正确无误。
• 如果服务器无法连接，请检查 API 密钥、插件状态以及网络环境。
• AI 操作笔记内容时，所有修改均可追溯。

MCP Obsidian 通过自然语言指令与 Obsidian 知识库交互，为用户提供高效、智能的知识管理体验。