English Français العربية

io.github.onetrueclaude-creator/mcp-knowledge-gaps

السجل الرسمي أخرى

Find what your knowledge base mentions but doesn't actually explain.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-knowledge-gaps
Claude Code 
claude mcp add mcp-knowledge-gaps -e 'KNOWLEDGE_GAPS_LICENSE=<your knowledge_gaps_license>' -- uvx mcp-knowledge-gaps==0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-knowledge-gaps": {
            "command": "uvx",
            "args": [
                "mcp-knowledge-gaps==0.1.0"
            ],
            "env": {
                "KNOWLEDGE_GAPS_LICENSE": "<your knowledge_gaps_license>"
            }
        }
    }
}

متغيرات البيئة

  • KNOWLEDGE_GAPS_LICENSE سري Pro license JWT (optional). Unlocks premium features. See README.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. mcp-knowledge-gaps
  2. Install
  3. Usage
  4. MCP Tools
  5. Pro tier
  6. Requirements
  7. License

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

الأسئلة الشائعة

ما هو io.github.onetrueclaude-creator/mcp-knowledge-gaps؟

Find what your knowledge base mentions but doesn't actually explain.

كيف أثبّت io.github.onetrueclaude-creator/mcp-knowledge-gaps؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-knowledge-gaps -e 'KNOWLEDGE_GAPS_LICENSE=<your knowledge_gaps_license>' -- uvx mcp-knowledge-gaps==0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.onetrueclaude-creator/mcp-knowledge-gaps إلى مفتاح API؟

نعم. يتطلب KNOWLEDGE_GAPS_LICENSE، وتضبطها في إعداداته.

هل io.github.onetrueclaude-creator/mcp-knowledge-gaps مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.onetrueclaude-creator/mcp-knowledge-gaps؟

ينشره onetrueclaude-creator. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.