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 分