Mcp Knowledge Gaps

io.github.onetrueclaude-creator由 GitHub 帳號 onetrueclaude-creator 發布v0.1.0更新於 Oct 24, 2026

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

已驗證STDIO僅桌面檔案與儲存知識與記憶資料與分析

概覽

AI 產生的概覽

掃描本機 Markdown 知識庫，找出被反覆提及卻始終沒有獨立筆記的概念。

可以做什麼
它會掃描 Markdown 筆記資料夾（例如 Obsidian 儲存庫或 Logseq 圖譜），回傳在多篇筆記中出現、卻沒有獨立筆記的概念。模糊正規化與雜訊過濾可減少誤判，缺口依出現頻率、區域多樣性與新穎度排序。Pro 工具可產生具優先順序的研究問題、隨機抽取低優先順序的長尾缺口，並匯出 CSV 複習佇列。
適用情境
適合維護大型 Markdown 知識庫、需要找出尚未展開的主題，或決定下一步研究、寫作方向時使用。它面向個人筆記庫與研究資料集，而非一般文件檢索。
執行需求
透過 stdio 在本機執行，需要 Python 3.10 以上版本，可用 pip 安裝或以 uvx 執行。僅支援桌面端，沒有遠端端點。選用的 Pro 授權透過 KNOWLEDGE_GAPS_LICENSE 環境變數、命令列參數或授權檔案提供。
安裝前請注意
Pro 工具需要以 KNOWLEDGE_GAPS_LICENSE 傳入授權權杖；授權完全離線驗證，權杖不會離開本機。匯出工具會寫入 CSV 檔到你指定的路徑。此伺服器會讀取你的 Markdown 儲存庫，請只指向你願意被掃描的資料夾。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Knowledge Gaps，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

bash
pip install mcp-knowledge-gaps# oruvx mcp-knowledge-gaps

Usage

Claude Code

bash
claude mcp add mcp-knowledge-gaps -- mcp-knowledge-gaps

Claude Desktop

Add to claude_desktop_config.json:

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:

bash
# 1. Environment variableexport KNOWLEDGE_GAPS_LICENSE="eyJhbGc..."
# 2. CLI flagmcp-knowledge-gaps --license-key "eyJhbGc..."
# 3. Config fileecho "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

來源：README.md，提交 cbe9d93

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分