mcp-knowledge-gaps

mcp-knowledge-gaps

找出知识库中提到却没有实际解释的内容。

找出 Markdown 知识库（Obsidian 知识库、Logseq 图谱或任何包含 .md 文件的文件夹）中提到但从未定义的概念。使用模糊规范化来避免误报，按频率 × 区域多样性 × 新颖度对知识缺口排序，生成优先级研究问题，并通过从长尾中抽样来打破研究队列中的确认偏差。

安装

pip install mcp-knowledge-gaps
# or
uvx mcp-knowledge-gaps

用法

Claude Code

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

Claude Desktop

添加到 claude_desktop_config.json：

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

MCP 工具

工具	级别	描述
find_gaps	免费	扫描 Markdown 知识库，返回在多篇笔记中提及、但没有专属笔记的概念。应用模糊规范化和噪声过滤。
list_gaps_by_priority	免费	按优先级返回知识缺口：频率 × 多样性 × 新颖度（越高 = 越应优先填补）。
generate_research_questions	专业版	为优先级最高的 N 个知识缺口生成研究问题。每个问题都附带优先级评分和因素明细。
surprise_research_topic	专业版	抽样选择——从低优先级长尾中随机挑选一个知识缺口。通过呈现你绝不会主动选择的主题，打破确认偏差。
export_review_queue	专业版	导出优先级最高的知识缺口概念 CSV，适用于 Anki 或其他间隔重复工具。写入 output_csv 并返回行数。

专业版

解锁基于 RL 加权排序的研究问题生成、长尾知识缺口的抽样选择，以及 CSV 复习队列导出。

许可证激活——以下任一方式均可：

# 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

许可证完全通过离线验证——不会连接回传，也无需激活服务。请访问 https://github.com/onetrueclaude-creator/mcp-knowledge-gaps#pro-tier 获取许可证。

要求

• Python 3.10+

许可证

MIT