Vault Brain
Indexes and queries an Obsidian vault as a knowledge graph, deterministically parsing YAML frontmatter, wikilinks (including headings and aliases), tags, and headings into NOTE/CONCEPT/PROJECT/TOOL/PERSON entities and typed relations. Provides multi-hop GraphRAG semantic retrieval, related-note discovery, topic tracing across notes, path finding between notes, and vault hub identification with context-aware evidence snippets.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Vault Brain ðŸ§
High-performance GraphRAG knowledge graph retrieval engine for Obsidian Vaults. Built for Hermes Agent & Vickry's personal second brain.
Features
Deterministic Obsidian Parser: Fast regex & AST extraction of YAML frontmatter, wikilinks (
[[Note#Section|Alias]]), headings, and tags.Strict Ontology: Enforces verified entity types (
NOTE,CONCEPT,PROJECT,TOOL,PERSON) and relations (RELATES_TO,DEPENDS_ON,IMPLEMENTS,PART_OF,OWNS,MENTIONED_IN).In-Memory NetworkX + SQLite Persistence: Lightning-fast graph traversal and pathfinding (<50ms) backed by persistent disk storage (
vault.db).GraphRAG Semantic Retrieval: Multi-hop semantic traversal and context-aware evidence snippet extraction.
Native MCP Server: Exposes
query_graph,find_related,trace_topic, andvault_hubsdirectly to Hermes and Claude Code.Zero Heavy External Dependencies: Pure Python (
networkx,pyyaml,mcp), RAM footprint < 80MB.
Related MCP server: Obsidian Knowledge MCP
CLI Usage
# Index Obsidian vault
vaultbrain index --vault /root/obsidian-vault --out /root/vaultbrain/vault.db
# Query graph for a concept or keyword
vaultbrain query "FastAPI"
# Trace topic evolution across notes
vaultbrain trace "Beemate"
# Find paths between two notes
vaultbrain path "Pikri" "FastAPI" --max-hops 3Running Tests
cd /root/vaultbrain
/usr/local/lib/hermes-agent/venv/bin/pytest tests/ -vTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Shared product-knowledge graph for AI agent fleets — vault tools + agent self-signup over MCP.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceConnects AI assistants to an Obsidian vault as a semantic knowledge graph, enabling graph navigation, semantic search, and content operations through MCP.471MIT
- FlicenseNot gradedqualityDmaintenanceEnables read-only querying of an Obsidian knowledge base through MCP tools and resources, including full-text search, node and link retrieval, related-note traversal, and pathfinding between concepts.1-
- AlicenseAqualityBmaintenanceExposes a typed, provenance-aware knowledge graph over an Obsidian vault to coding agents over MCP, so they can trace what grounds a claim, compute which other notes a change makes wrong, surface contradictions and admitted gaps, and assemble a task-specific token-budgeted subset of the vault. Indexing, retrieval, and impact analysis run with zero third-party runtime dependencies beyond the Python standard library.10MIT
- AlicenseBqualityBmaintenanceEnables AI agents and developers to inspect Obsidian vault knowledge graphs, navigate backlinks, detect broken wikilinks, lint note compliance, search indexed notes, and scaffold standards-compliant Markdown notes via MCP.6MIT