A
licenseA
qualityD
maintenanceScans markdown vaults to identify concepts mentioned but not defined, ranks gaps by priority, and generates research questions or random long-tail topics to fill knowledge gaps.
5
MIT
mcp-knowledge-gaps
by ermintoygar
Exports the top-priority knowledge gap concepts as a CSV file suitable for importing into Anki or other spaced-repetition tools.
Scans a Logseq graph to identify concepts mentioned across notes but lacking a dedicated definition note, surfacing knowledge gaps.
Scans an Obsidian vault to identify concepts mentioned across notes but lacking a dedicated definition note, surfacing knowledge gaps.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-knowledge-gapsfind concepts I mention but never define in my notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-knowledge-gaps
Find what your knowledge base mentions but doesn't actually explain.
Find concepts mentioned but never defined in your markdown knowledge base (Obsidian vault, Logseq graph, any folder of .md files). Uses fuzzy canonicalization to avoid false positives, ranks gaps by frequency × region-diversity × novelty, generates prioritized research questions, and samples from the long tail via sortition to break confirmation bias in your research queue.
Install
pip install mcp-knowledge-gaps
# or
uvx mcp-knowledge-gapsRelated MCP server: mcp-curiosity-engine
Usage
Claude Code
claude mcp add mcp-knowledge-gaps -- mcp-knowledge-gapsClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"knowledge_gaps": {
"command": "uvx",
"args": ["mcp-knowledge-gaps"]
}
}
}MCP Tools
Tool | Tier | Description |
| Free | Scan a markdown vault and return concepts mentioned in multiple notes but without their own dedicated note. Applies fuzzy canonicalization and noise filtering. |
| Free | Return gaps ranked by priority: frequency × diversity × novelty (higher = fill this gap first). |
| Pro | Generate prioritized research questions for the top N gaps. Each question comes with a priority score and factor breakdown. |
| Pro | Sortition sampling — pick a random gap from the LOW-priority long tail. Breaks confirmation bias by surfacing topics you'd never pick yourself. |
| Pro | Export a CSV of top-priority gap concepts, suitable for Anki or other spaced-repetition tools. Writes to output_csv and returns the row count. |
Pro tier
Unlocks research question generation with RL-weighted ranking, sortition sampling of long-tail gaps, and CSV review queue export.
License activation — any one of these works:
# 1. Environment variable
export KNOWLEDGE_GAPS_LICENSE="eyJhbGc..."
# 2. CLI flag
mcp-knowledge-gaps --license-key "eyJhbGc..."
# 3. Config file
echo "eyJhbGc..." > ~/.mcp-knowledge-gaps/license.jwtLicenses are verified fully offline — no phone-home, no activation server. Get a license at https://github.com/ermintoygar/mcp-knowledge-gaps#pro-tier.
Requirements
Python 3.10+
License
MIT
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Personal context for every AI: search, read, and write back to your private Markdown library.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Research-backed linting + generation for agent context files (CLAUDE.md, AGENTS.md, Cursor rules).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceSurface forgotten notes from markdown vaults using DMN-inspired replay cycle to identify dormant notes and generate cross-domain connections.MIT
- AlicenseNot gradedqualityCmaintenanceProvides retrieval and graph tools for agents to search, backlink, and navigate a markdown-based knowledge vault, enabling hybrid search and serendipitous discovery.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to explore and analyze a markdown vault as a traversable knowledge graph, with tools for searching, traversing, and finding implicit semantic connections between notes.-