Obsidian Vault MCP

专为 Obsidian Vault 设计的 MCP 服务器，提供知识库专用工具。

安装

npm install -g obsidian-vault-mcp
# 或
npx obsidian-vault-mcp --vault /path/to/vault

使用

obsidian-vault-mcp --vault /path/to/your/vault

提供的工具

| 工具 | 功能 | |-----|------| | search_notes | 按标题、内容、标签搜索笔记 | | get_note_metadata | 获取笔记的 frontmatter 和元数据 | | get_backlinks | 获取指向某笔记的所有反向链接 | | list_by_tag | 按标签列出所有笔记 | | get_vault_structure | 获取 vault 目录结构 | | get_recent_notes | 获取最近修改的笔记 | | create_note | 创建带 frontmatter 的新笔记 |

在 Claude Code ACP 中配置

在 Obsidian ACP 插件设置中添加 MCP 服务器：

{
  "id": "vault",
  "name": "Obsidian Vault",
  "type": "stdio",
  "command": "npx",
  "args": ["obsidian-vault-mcp", "--vault", "{VAULT_PATH}"],
  "enabled": true
}

工具详情

search_notes

搜索笔记，支持按标题、内容、标签搜索。

{
  "query": "搜索关键词",
  "searchIn": "all",  // title | content | tags | all
  "limit": 20
}

get_note_metadata

获取笔记的完整元数据。

{
  "path": "folder/note.md"
}

返回：

{
  "path": "folder/note.md",
  "frontmatter": { "title": "...", "tags": ["..."] },
  "tags": ["tag1", "tag2"],
  "links": ["other-note", "another"],
  "modified": "2025-01-01T00:00:00Z",
  "created": "2024-12-01T00:00:00Z",
  "size": 1234
}

get_backlinks

获取所有链接到指定笔记的笔记。

{
  "path": "folder/note.md"
}

list_by_tag

获取包含特定标签的所有笔记。

{
  "tag": "project"  // 不需要 #
}

get_vault_structure

获取 vault 的目录结构。

{
  "depth": 2  // 遍历深度
}

get_recent_notes

获取最近修改的笔记。

{
  "limit": 10,
  "days": 7
}

create_note

创建新笔记。

{
  "path": "folder/new-note.md",
  "content": "# New Note\n\nContent here...",
  "frontmatter": {
    "title": "New Note",
    "tags": ["new", "example"]
  }
}

License

MIT