Graph RAG MCP Server for Obsidian (saselvan/graph-rag-mcp-server-fixed) is an MCP server listed on the M8ven Trust Index. It scores 52 out of 100, grade D. It declares 40 tools. No publisher has claimed this listing.
A local-first Graph-RAG system combining ChromaDB with metadata-based graph relationships and Gemini 2.5 Flash for intelligent Q&A over Obsidian vaults, supporting MCP clients like Claude Desktop, Cursor, and Raycast.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
saselvan
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
smart_searchIntelligent search that analyzes query intent and chooses optimal search strategy. Always returns a JSON-serializable dict. On any internal failure, falls back to a minimal, empty result instead of surfacing transport-level errors. This replaces basic search with smart routing between: - Vector simi…
health_checkRun registered health checks and return component status.
get_dspy_optimization_statusReturn current DSPy optimization status and scheduling details.
force_dspy_optimizationForce a DSPy optimization run if available and not already running.
search_notesBasic vector search across vault chunks using ChromaDB. Note: Consider using smart_search instead for better results with intelligent routing.
answer_questionEnhanced RAG-powered Q&A using intelligent search routing and Gemini 2.5 Flash. Uses smart search routing to find the most relevant content through: - Vector similarity for semantic questions - Graph traversal for relationship questions - Tag matching for categorical questions - Hybrid approach for …
graph_neighborsGet neighboring notes in the graph up to specified depth.
get_subgraphGet a subgraph containing seed notes and their neighbors.
list_notesList notes with optional vault and time-based filtering.
read_noteRead the full content of a note by path.
get_note_propertiesGet frontmatter properties of a note.
update_note_propertiesUpdate frontmatter properties of a note.
archive_noteMove a note to the archive folder.
create_notecreate_folderCreate a new folder in the vault.
add_content_to_noteAdd content to an existing note.
update_note_sectionget_backlinksGet all notes that link to the specified note.
get_notes_by_tagGet all notes that have the specified tag.
traverse_from_chunkTraverse the graph starting from a specific semantic chunk. This provides chunk-level graph navigation, allowing you to explore relationships from any specific piece of content in the vault.
get_related_chunksFind chunks related to a query through graph relationships. Unlike vector search, this finds chunks connected through the graph structure (links, backlinks, hierarchical relationships).
explore_chunk_contextGet surrounding context for a specific chunk. Returns the chunk along with its sequential neighbors and hierarchical context, useful for understanding the full context around a specific piece of content.
reindex_vaultenrich_notesEnrich notes with PARA taxonomy and semantic relationships. Args: note_paths: Specific note paths to enrich. If None, enriches all notes. limit: Maximum number of notes to process (if note_paths is None) dry_run: If True, analyze but don't save changes (default: False) Returns: EnrichmentResult with…
list_basesList all .base files in the vault with their metadata. Returns: List of BaseInfo objects containing base file information
read_baseRead and parse a .base file by its ID. Args: base_id: The base file ID to read Returns: Parsed base file configuration as dictionary, or None if not found
validate_baseValidate .base file content syntax and structure. Args: content: The .base file content to validate format: Optional format hint (json or yaml) Returns: Dictionary with 'valid' boolean and optional 'error' message
execute_base_queryExecute a base query and return matching notes. Args: base_id: The base file ID to execute view_id: Optional specific view to use limit: Optional limit on number of results Returns: Query results with matching notes and metadata
get_base_viewGet formatted data for a specific base view. Args: base_id: The base file ID view_id: The view ID to format Returns: Formatted view data for display
create_baseCreate a new .base file with basic configuration. Args: name: Name for the new base description: Optional description folders: Folders to include (defaults to root) filters: Optional filter conditions Returns: Dictionary with 'success' boolean, 'base_id', 'path', and optional 'error'
list_base_filesList all .base files in the vault. Returns: Dictionary with 'success' boolean, 'base_files' list, and optional 'error'
check_base_existsCheck if a base file exists. Args: base_id: The base file ID to check Returns: Dictionary with 'exists' boolean, file info if exists, and optional 'error'
update_baseUpdate an existing .base file configuration. Args: base_id: The base file ID to update updates: Dictionary of updates to apply Returns: Dictionary with 'success' boolean and optional 'error'
base_from_graphCreate a new .base file from a selection of notes (graph-friendly). This tool enables creating bases from graph selections, making it easy to save curated collections of related notes discovered through graph traversal. Args: note_ids: List of note IDs to include name: Name for the new base descript…
enrich_base_with_graphEnrich a base with graph relationship data as computed fields. Adds computed fields for graph metrics like link count, centrality, and cluster information to enhance base views with graph insights. Args: base_id: The base file ID to enrich Returns: Dictionary with 'success' and enrichment details
get_cache_statsGet detailed cache statistics for monitoring and optimization.
clear_cachesClear specified caches or all caches if no names provided. Args: cache_names: Optional list of cache names to clear. If None, clears all caches. Returns: Status of cache clearing operation.
OBSIDIAN_RAG_CHROMA_DIR/custom/path/to/.chroma_dbGEMINI_API_KEYEdit .env and add your and vault pathsOBSIDIAN_VAULT_PATHOBSIDIAN_RAG_VAULTS"": "/path/to/your/vault"OBSIDIAN_RAG_VAULT_PATHCHROMA_DIROBSIDIAN_RAG_DSPY_STATE_DIRDSPY_STATE_DIRXDG_CACHE_HOMEIntegration tests run without network. Embeddings fall back to a built‑in default and DSPy caches write to .cache/. Override with or DSPY_CACHEDIR if needed.DSPY_CACHEDIRIntegration tests run without network. Embeddings fall back to a built‑in default and DSPy caches write to .cache/. Override with XDG_CACHE_HOME or if needed.Tool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
40/40 tools missing one or more hints — smart_search (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); health_check (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_dspy_optimization_status (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +37 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Descriptions match behaviour
1 tool describes read intent but its handler mutates — enrich_base_with_graph (line 2960: base_path.write_text(base_json, encoding='utf-8'))
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
31/40 tool handlers declare input schemas (78%)
Declare an inputSchema with zod/joi/yup on every tool definition.
Tool handlers catch errors
31/40 tool handlers wrap calls in try/catch (78%)
Wrap each tool handler body in try/catch and return a structured error response.
License file
No license file
Add a LICENSE file (MIT, Apache-2.0, etc.).
Tests exist
No test files found
Add tests that exercise each declared tool.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/saselvan/graph-rag-mcp-server-fixed)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check