Librarian
Give Claude a librarian for your markdown vault.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
Librarian is the Karpathy LLM Wiki pattern, productionized as an MCP server — bidirectional graph traversal, auto-wikilinks, trigram search, community detection, and a D3 graph view, all from inside Claude. Works against any Obsidian vault or plain folder of markdown files.
Runs entirely locally. Your vault data never leaves your machine. Librarian reads and writes files on disk and communicates with Claude over stdio. No network calls, no telemetry, no cloud storage.
# 1. Install
brew install ngmeyer/tap/librarian-mcp
# 2. Point at your vault and auto-configure Claude
librarian-mcp --setup ~/my-vault
# 3. Restart Claude, then try:
# /librarian analyze — see your vault's knowledge graph
# /librarian search — find anything across all notes
# /librarian status — vault health overview
--setup writes the MCP server config into Claude Desktop and Claude Code (with backups), and installs the /librarian skill so you get 12 slash commands out of the box.
brew install ngmeyer/tap/librarian-mcp
Download from GitHub Releases for macOS (arm64/x86_64), Linux (arm64/x86_64), and Windows. Place the binary on your PATH.
cargo install --git https://github.com/ngmeyer/librarian-mcp
Librarian is a standalone binary — it works directly on your markdown files. Obsidian does not need to be running (and they can run simultaneously without conflict). Claude connects via the Model Context Protocol over stdio.
librarian-mcp --setup ~/my-vault
This auto-configures Claude Desktop and Claude Code (with backups of existing configs). Restart Claude to connect.
librarian-mcp --setup ~/vaults/notes ~/vaults/research
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json) or Claude Code config (~/.claude/settings.json):
{
"mcpServers": {
"librarian": {
"command": "librarian-mcp",
"args": ["/path/to/your/vault"]
}
}
}
LIBRARIAN_VAULT=/path/to/vault # Single vault
LIBRARIAN_VAULTS=/vault/one:/vault/two # Multiple vaults (colon-separated, Unix only)
Librarian exposes 17 tools to Claude:
--setup installs a Claude Code skill that gives you 12 high-level commands built on the tools above:
The repo includes a 16-file example vault demonstrating multi-lens research analysis — 6 analytical lenses that force different perspectives on any topic.
To try it after cloning:
git clone https://github.com/ngmeyer/librarian-mcp
cd librarian-mcp
librarian-mcp --setup examples/research-skill-graph
Then in Claude Code: "Follow the execution instructions in index.md. Research: Why are prediction market edges compressing?"
The vault includes source evaluation (5-tier trust system), contradiction protocol, synthesis rules, and a knowledge layer that compounds across projects. See examples/research-skill-graph/index.md for the full system.
When Claude writes files via library_write, Librarian scans for mentions of existing note titles and wraps them in [[wikilinks]]. This happens only on explicit writes — Librarian never modifies files you didn't ask it to write.
Links use canonical file names so they resolve correctly in Obsidian's graph view, even on case-sensitive filesystems. Frontmatter aliases are supported: if a note has aliases: [ML, machine learning], mentions will auto-link using [[Note Name|ML]] format.
Auto-linking skips code blocks, inline code, URLs, and existing wikilinks to avoid corrupting content.
Librarian builds a bidirectional graph from your vault's [[wikilinks]] and exposes three graph tools:
Louvain modularity optimization identifies topic clusters in your vault. Combined with betweenness centrality and PageRank, the report tool ranks "god nodes" (structurally important notes) and finds surprising cross-community connections.
Search is backed by an in-memory trigram index built on startup. Handles vaults with 10,000+ files.
By default, Librarian skips .obsidian/, .trash/, .git/, and node_modules/. Drop a .librarianignore file (gitignore syntax) in your vault root to customize:
# .librarianignore
templates/
private/
Librarian works seamlessly alongside Obsidian — both can be open at the same time:
[[wikilinks]] and [[note|display text]]aliases.obsidian/ and .trash/ directoriesJournal/YYYY/YYYY-MM-DD.md conventionMIT
The Karpathy LLM Wiki pattern, productionized. MCP server that gives Claude a librarian for your Obsidian vault — graph traversal, auto-wikilinks, trigram search.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Librarian 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 The Karpathy LLM Wiki pattern, productionized. MCP server that gives Claude a librarian for your Obsidian vault — graph traversal, auto-wikilinks, trigram search.