obsidian-mcp-server

概述

这个MCP服务器为AI助手与Obsidian知识库交互提供全面功能。支持笔记和目录的CRUD操作、前置元数据和标签管理、全文搜索功能以及链接分析。服务器支持多种部署方式，包括直接npx执行、Docker容器和本地开发环境。实现了SSE和POST端点的MCP通信，并可选择API密钥进行身份验证。

试试问 AI

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

• read-note

  Read note contents (supports frontmatterOnly for efficiency)

  试试:Read the contents of my meeting notes试试:Get just the frontmatter from my project plan
• create-note

  Create a new note

  试试:Create a new note called 'Project Ideas'试试:Make a new entry for today's journal
• edit-note

  Replace note contents

  试试:Update my project timeline试试:Edit the conclusion section of my research paper
• write-note

  Write with modes: overwrite, append, or prepend

  试试:Add this new information to my existing notes试试:Prepend my note with today's date
• get-frontmatter

  Get YAML frontmatter as JSON

  试试:Show me the frontmatter of my presentation试试:Get the metadata from my blog post
• add-tags

  Add tags to frontmatter or inline

  试试:Tag this note with 'important' and 'todo'试试:Add 'research' and '2023' to my notes
• search-vault

  Full-text search with context

  试试:Find all notes about my marketing strategy试试:Search for references to 'blockchain'
• get-backlinks

  Find notes linking to a note

  试试:Which notes link to my project outline?试试:Find all pages that reference this concept
• find-broken-links

  Find unresolved wiki-links

  试试:Check for broken links in my notes试试:Find all unresolved references in my knowledge base
• list-vault

  List files and directories

  试试:Show me all notes in my projects folder试试:List all directories in my vault
• list-tags

  List all tags with counts

  试试:Show me all tags in my vault试试:List the most frequently used tags
• find-replace

  Bulk find and replace

  试试:Replace all instances of 'old name' with 'new name'试试:Fix typos in multiple notes at once

可对比工具

安装

VAULT_PATH=/path/to/your/vault npx @smith-and-web/obsidian-mcp-server

docker run -d \
  --name obsidian-mcp \
  -v /path/to/your/vault:/vault:rw \
  -p 3001:3000 \
  -e VAULT_PATH=/vault \
  ghcr.io/smith-and-web/obsidian-mcp-server:latest

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3001/sse"]
    }
  }
}

FAQ

是否需要身份验证？

身份验证是可选的。当设置API_KEY环境变量时，所有端点都需要通过Bearer令牌或查询参数进行身份验证。

除了Claude，我还能与其他AI助手一起使用吗？

可以，任何兼容MCP的客户端都可以使用mcp-remote工具或直接连接到SSE端点来连接到此服务器。

obsidian-mcp-server 对比