knowledge-mcp

把私有笔记变成可检索的向量库，每次和 AI 助手对话时自动补全上下文。

快速开始

# 1. 安装
pip install knowledge-mcp

# 2. 创建知识库目录
mkdir my-knowledge-base && cd my-knowledge-base
mkdir data  # 放入你的 .md / .txt 文件

# 3. 配置 MCP 客户端（见下方"注册到 AI 助手"）

# 4. 索引文件（在 AI 助手中）
# knowledge_index data/

# 5. 提问即可自动检索

注册到 AI 助手

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "knowledge-base": {
      "command": "python",
      "args": ["-m", "knowledge_mcp"],
      "cwd": "."
    }
  }
}

支持的 AI 客户端：Claude Code、Cursor、以及所有支持 MCP 协议的工具。

Claude Code 用户可在 settings.json 中设置 "enabledMcpjsonServers": ["knowledge-base"] 跳过每次的确认弹窗。

工作原理

用户提问 → AI 客户端判定需检索 → 调用 knowledge_search
         → 查询向量化（BGE-small-zh-v1.5）
         → LanceDB 向量相似度搜索
         → 返回 top-5 相关文本片段
         → AI 客户端组装 prompt + 检索结果 → 生成回答

提供的 MCP 工具

配置

通过环境变量覆盖默认值：

技术选型

开发

git clone <repo-url>
cd personal-knowledge-base
pip install -e .
# 将 .mcp.dev.json 的内容覆盖到 .mcp.json（或直接用全局 ~/.mcp.json 配绝对路径）