obsidian-mcp-server

概述

obsidian-mcp-server 提供 14 个工具和 3 个资源，可全面访问 Obsidian 笔记库。它支持多种格式的笔记读取，包括原始内容、完整结构化文档和文档地图。服务器通过修补、替换和追加等操作工具进行精细编辑，可对笔记、标签和前置元数据进行精细控制。它还提供文本、Dataview DQL 和 JSONLogic 模式的搜索功能，使其能够满足不同查询需求。服务器通过环境变量实现强大的权限控制，允许路径范围访问和只读配置，确保安全部署。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• obsidian_get_note

  Read a note in various formats (raw content, structured form, document map, or specific section).

  试试:Get the full content of my daily note试试:Show me the document map for my project notes试试:Retrieve the frontmatter from my meeting notes
• obsidian_list_notes

  List notes and subdirectories at a vault path with filtering options.

  试试:List all notes in my projects folder试试:Show me all markdown files in my vault试试:Find notes with 'review' in their name
• obsidian_list_tags

  List all tags found across the vault with usage counts.

  试试:Show me all tags in my vault试试:Which tags are used most frequently?试试:List all tags in my 'work' folder
• obsidian_search_notes

  Search the vault by text, Dataview DQL, or JSONLogic with context windows.

  试试:Search for notes about project deadlines试试:Find all mentions of 'Q3 planning' in my notes试试:Search using Dataview to find all tasks marked as urgent
• obsidian_write_note

  Create a note or replace a specific section, with protection against accidental overwrites.

  试试:Create a new note called 'meeting-notes.md'试试:Replace the 'Action Items' section in my project notes试试:Overwrite the entire weekly note with new content
• obsidian_append_to_note

  Append content to a note or create the note if it doesn't exist.

  试试:Add these action items to my meeting notes试试:Append today's tasks to my todo list试试:Create a new daily note with today's date and content
• obsidian_patch_note

  Surgically edit a specific section of a note (append, prepend, or replace).

  试试:Add this agenda item before the 'Discussion' section试试:Replace the entire 'Summary' section in my project notes试试:Prepend this context to the top of my research notes
• obsidian_replace_in_note

  Perform body-wide search-replace operations in a single note.

  试试:Replace all instances of 'old-name' with 'new-name' in my project notes试试:Fix typos throughout my document试试:Replace every occurrence of 'deadline' with 'due date'
• obsidian_manage_frontmatter

  Get, set, or delete frontmatter keys in a note.

  试试:Set the 'status' frontmatter field to 'completed'试试:Get the value of the 'project' field from my notes试试:Delete the 'draft' frontmatter tag
• obsidian_manage_tags

  Add, remove, or list tags on a note, reconciling frontmatter and inline syntax.

  试试:Add the 'urgent' tag to my task notes试试:Remove the 'archived' tag from this note试试:List all tags on my current note
• obsidian_delete_note

  Permanently delete a note with confirmation when supported.

  试试:Delete the old version of my project notes试试:Remove this outdated meeting note试试:Permanently delete the 'draft-ideas' file
• obsidian_open_in_ui

  Open a file in the Obsidian app UI.

  试试:Open my current project notes in Obsidian试试:Show me the monthly note in the UI试试:Open the 'research' folder in a new pane

可对比工具

安装

npm install -g obsidian-mcp-server

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp-server",
      "args": []
    }
  }
}

FAQ

使用此 MCP 服务器需要什么？

服务器需要安装了 Local REST API 插件的 Obsidian。还需要 Node.js 或 Bun 运行时。

如何控制文件权限？

通过环境变量：OBSIDIAN_READ_PATHS、OBSIDIAN_WRITE_PATHS 和 OBSIDIAN_READ_ONLY，用于限制对特定笔记库路径的访问。

obsidian-mcp-server 对比