Obsidian MCP

io.github.seynurmammad0v由 GitHub 账号 seynurmammad0v 发布v1.0.3更新于 Oct 25, 2026

Turns Obsidian vaults into AI-queryable knowledge graphs with 12 tools

已验证STDIO仅桌面文件与存储知识与记忆

概览

AI 生成的概览

一个本地 MCP 服务器，把 Obsidian 笔记库索引为链接图谱，让助手读取、搜索、遍历并编辑笔记及其双链。

可以做什么
读取与发现笔记：库统计、含 frontmatter、链接、反向链接与分节的完整内容，以及标签、文件夹、frontmatter 和关键词的组合搜索。遍历链接图谱：直接相邻笔记、指定深度的 BFS/DFS、两篇笔记间的最短链接路径，以及连通分量、孤立笔记、桥接、枢纽和失效链接分析。写入与整理：创建笔记，追加、前置或替换分节，更新 frontmatter，移动或重命名笔记并自动更新反向链接，删除笔记，以及全库添加、移除或重命名标签。
适用场景
适合用 Obsidian 笔记库记录知识、并希望助手跨链接笔记回答问题、梳理笔记间关系，或执行移动笔记并修正引用这类批量修改的场景。它面向个人知识库的图谱式探索，而非通用文件管理。
运行要求
通过 npx 以 stdio 在本地运行，需要 Node.js。必须用 --vault 参数指定笔记库路径。无需数据库、运行中的 Obsidian、API 密钥或环境变量；可选配置放在笔记库根目录的 .obsidian-mcp.json 文件中。
安装前请注意
写入类工具会改动磁盘文件：创建、修补、移动和删除笔记，以及全库重命名标签。移动笔记会重写整个库中的引用，删除只报告失效链接而不会修复。只指向你愿意被修改的笔记库，并保留备份或版本控制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Obsidian MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

obsidian-mcp

MCP server that turns any Obsidian vault into an AI-queryable knowledge graph.

What makes this different from the 24+ existing Obsidian MCP servers:

  • Graph-first — BFS, shortest path, connected components, bridge detection via [[wikilinks]]
  • Zero infrastructure — No database, no Obsidian running, no API keys
  • Vault-agnostic — Works with any existing vault, no required structure
  • Backlink-aware writes — move_note auto-updates all references across the vault
  • Tiny — 4 runtime dependencies, ~42KB bundle

Quick Start

bash
npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "obsidian": {      "command": "npx",      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]    }  }}

Claude Code

bash
claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Tools (12)

Reading & Discovery

ToolDescription
vault_statsOverview: total notes, tags, links, orphans, components, top tags/hubs
read_noteFull content + frontmatter + links + backlinks + sections
search_notesFilter by tags, folder, frontmatter, keyword. All combinable

Graph Traversal

ToolDescription
graph_neighborsDirect links + backlinks for a note
graph_traverseBFS/DFS from a note, N hops deep with tag filtering
graph_shortest_pathShortest link chain between two notes
graph_analyzeComponents, orphans, bridges, hubs, dead links

Writing & Manipulation

ToolDescription
create_noteCreate with content + frontmatter
patch_noteAppend, prepend, or replace a section. Update frontmatter
move_noteRename/move + auto-update all backlinks across vault
delete_noteDelete + report broken links
manage_tagsAdd/remove/rename tags (vault-wide rename supported)

Configuration

Zero-config by default. Optional .obsidian-mcp.json in vault root:

json
{  "ignore": ["templates/", "daily-notes/", ".trash/"],  "watchDebounce": 100,  "maxTraversalDepth": 10,  "maxSearchResults": 500}

CLI Flags

--vault <path>       Path to Obsidian vault (required)--verbose            Enable debug logging--log-level <level>  error | warn | info | debug (default: info)

How It Works

  1. On startup, scans all .md files and builds an in-memory graph (~1-3s for 1k notes)
  2. File watcher detects changes and updates the graph incrementally (~5ms per change)
  3. Claude queries the graph via MCP tools — no re-scanning needed
  4. Write operations update both the filesystem and the graph atomically

Hardcoded exclusions: .obsidian/, .trash/, node_modules/

Development

bash
npm installnpm test              # Run 66 testsnpm run build         # Build to dist/npm run dev -- --vault test/fixtures/vault  # Dev mode

License

MIT

来源：README.md，提交 8008844

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分