mcpField
M
mcp-knowledge-gaps

mcp-knowledge-gaps

Local
github.com/onetrueclaude-creatorMemory & Knowledge0Updated 28w ago
Repository

About mcp-knowledge-gaps

mcp-knowledge-gaps scans Markdown knowledge bases for concepts mentioned across notes but lacking a dedicated note. It helps people identify and prioritize research gaps, using fuzzy concept matching and ranking based on frequency, diversity, and novelty.

Key features

  1. 01Find concepts without dedicated notes
  2. 02Normalize similar concept names
  3. 03Rank gaps by frequency, diversity, and novelty
  4. 04Generate prioritized research questions
  5. 05Export a CSV review queue

Use cases

  1. 01Identify unexplained concepts in a Markdown vault
  2. 02Prioritize topics for further research
  3. 03Generate questions about the highest-priority gaps
  4. 04Export gap topics for spaced-repetition review

MCP support

It provides MCP tools to find and rank knowledge gaps, generate research questions, sample lower-priority topics, and export a CSV review queue.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "onetrueclaude-creator-mcp-knowledge-gaps": {
      "command": "uvx",
      "args": [
        "mcp-knowledge-gaps"
      ],
      "env": {
        "KNOWLEDGE_GAPS_LICENSE": "<KNOWLEDGE_GAPS_LICENSE>"
      }
    }
  }
}
Run commanduvx mcp-knowledge-gaps
Environment variables to set
KNOWLEDGE_GAPS_LICENSESecretPro license JWT (optional). Unlocks premium features. See README.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-knowledge-gaps0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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-gaps

Usage

Claude Code
claude mcp add mcp-knowledge-gaps -- mcp-knowledge-gaps
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "knowledge_gaps": {
      "command": "uvx",
      "args": ["mcp-knowledge-gaps"]
    }
  }
}

MCP Tools

ToolTierDescription
find_gapsFreeScan a markdown vault and return concepts mentioned in multiple notes but without their own dedicated note. Applies fuzzy canonicalization and noise filtering.
list_gaps_by_priorityFreeReturn gaps ranked by priority: frequency × diversity × novelty (higher = fill this gap first).
generate_research_questionsProGenerate prioritized research questions for the top N gaps. Each question comes with a priority score and factor breakdown.
surprise_research_topicProSortition sampling — pick a random gap from the LOW-priority long tail. Breaks confirmation bias by surfacing topics you'd never pick yourself.
export_review_queueProExport 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.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license at https://github.com/onetrueclaude-creator/mcp-knowledge-gaps#pro-tier.

Requirements

  • Python 3.10+

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.