adelaidasofia avatar

FastMCP server for surgical queries against a vault knowledge graph (NetworkX no

adelaidasofia/graph-query-mcp

If you've built a knowledge graph from your Obsidian vault using NetworkX, this server lets Claude query it surgically instead of dumping 50K lines of graph data into context every time. It loads your graph.json once at startup and exposes seven tools: fuzzy node search, neighbor traversal with configurable hop depth, shortest path finding, degree-ranked top nodes, subgraph extraction around concept clusters, detailed node metadata, and community detection lookups. Supports dual graphs if you maintain separate personal and team vaults. Pairs naturally with the graphify skill from ai-brain-starter, though any NetworkX node-link JSON works. Query latency under 50ms, all in-memory, no external services.

GitHub stars
2
tools
7
auth
Required
transport
STDIO
env var
1
last updated
May 20, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

search_nodesFuzzy match against node names. Returns node IDs ranked by exact / starts-with / contains.

Fuzzy match against node names. Returns node IDs ranked by exact / starts-with / contains.

No parameter schema in public metadata yet.

get_neighborsConnected nodes within N hops, sorted by degree.

Connected nodes within N hops, sorted by degree.

No parameter schema in public metadata yet.

find_pathShortest path between two concepts. Auto-fuzzy-matches both ends.

Shortest path between two concepts. Auto-fuzzy-matches both ends.

No parameter schema in public metadata yet.

get_top_nodesHighest-degree nodes (the "god nodes").

Highest-degree nodes (the "god nodes").

No parameter schema in public metadata yet.

query_subgraphSubgraph around a list of concepts; reports node + edge counts.

Subgraph around a list of concepts; reports node + edge counts.

No parameter schema in public metadata yet.

get_node_infoFull metadata + top neighbors for one node.

Full metadata + top neighbors for one node.

No parameter schema in public metadata yet.

get_community_membersAll nodes in the same community-detection cluster.

All nodes in the same community-detection cluster.

No parameter schema in public metadata yet.

Sponsors

Configuration

GRAPH_JSON_PATH*

Absolute path to your graphify-out/graph.json

Readme

Details

Repository
github.com/adelaidasofia/graph-query-mcp
Categories
Documents & Knowledge, Data & Analytics
Package
https://github.com/adelaidasofia/graph-query-mcp/releases/download/v0.1.0/graph-query-mcp.mcpb
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from adelaidasofia

Related Documents & Knowledge MCP servers

View all
1sofya-co avatarSofyasofya-co/sofya-mcpWeb search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.2stars
2emcd avatarnb-mcp-serveremcd/nb-mcp-serverMCP server wrapping the nb CLI for LLM-friendly note-taking0stars
3calypso-so avatarCalypso Multimodal RAG MCPcalypso-so/calypso-mcp-serverCalypso multimodal RAG for grounded answers from docs, images, charts, and knowledge.2stars
4ddmanyes avatarsecond-brain MCPddmanyes/second-brain-mcpSelf-maintaining knowledge vault: figure-level search, auto-wikilinks, and memory compression.2stars
5gogogadgetbytes avatarSmart Connectionsgogogadgetbytes/smart-connections-mcpMCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.2stars
6libres-coder avatarParseflowlibres-coder/parseflowPDF parsing server with text extraction, metadata, search, images, and TOC via MCP2stars