kb-mcp-lite

<div align="center"> # kb-mcp-lite **面向AI代理的轻量级本地知识库 · 团队协作友好** `pip install kb-mcp-lite` — 让任何AI编程助手都拥有结构化、可查询、可同步的团队"第二大脑" [](https://pypi.org/project/kb-mcp-lite/) [](https://www.python.org/) [](./LICENSE) [](https://modelcontextprotocol.io/) [](#状态说明) </div> --- ## 🎯 解决什么问题 当前的知识管理工具存在明显的断层： - 面向人类的知识库（Notion/Obsidian）：需要手动维护，AI无法直接高效访问 - 向量数据库：需要复杂配置，没有结构化Schema，团队协作困难 - 团队文档散落在各个地方：代码注释、Wiki、PR描述、飞书文档，AI找不到也用不了 `kb-mcp-lite` 专门填补这个空白：**专为AI代理设计，同时兼顾人类编辑和团队协作**，让AI编程助手可以直接调用团队沉淀的所有技术知识。 | 对比维度 | Notion/Obsidian | Chroma/LanceDB等向量库 | **kb-mcp-lite** | |---|---|---|---| | 服务对象 | 人类 | 模型嵌入 | **AI代理 + 人类开发者** | | 访问方式 | Web UI | SDK调用 | **MCP标准协议（AI原生） + CLI + Web管理后台** | | 结构规范 | 自由格式 | 无结构 | **强Schema（标准化文档类型）** | | 存储方案 | 云服务/私有部署 | 本地文件 | **SQLite + FTS5 单文件存储** | | 团队协作 | 在线协作 | 无协作能力 | **Git原生同步，纯文本版本管理** | | 部署成本 | 账号/服务器 | 安装配置 | **`pip install` 开箱即用，零配置** | | 数据隐私 | 云服务存储 | 本地 | **完全本地存储，无云服务，无遥测** | --- ## ✨ 核心能力详解 ### 1. 📐 强Schema标准化与结构化Metadata 内置9种开箱即用的文档类型，覆盖技术团队90%的知识沉淀场景，所有类型支持结构化Typed Metadata并可通过Python子类扩展： | 文档类型 | ID前缀 | 用途说明 | 结构化Metadata亮点 | |---|---|---|---| | `project` | `proj` | 项目/仓库说明文档 | 记录技术栈、负责人、状态、部署流程 | | `decision` | `dec` | 架构决策记录(ADR) | 结构化记录 `status`(accepted/superseded)、决策人、替代方案 | | `lesson` | `lesson` | 经验教训/踩坑记录 | 结构化记录 `severity`、根因归类、避坑准则 | | `glossary` | `glossary` | 术语表 | 统一业务/技术专有名词标准定义 | | `person` | `person` | 人员档案 | 团队成员技术栈、模块分工与联系方式 | | `faq` | `faq` | 常见问题 | 沉淀高频问答，消除重复咨询 | | `api` | `api` | API接口文档 | 结构化记录 HTTP Method、Path、鉴权与限流要求 | | `runbook` | `runbook` | 运维手册(SOP) | 标准化运维及应急处置步骤 | | `release` | `release` | 发布日志 | 版本号、变更清单、影响范围与回滚步骤 | **优势**： - **真实结构化元数据**：支持 JSON 字段与 Frontmatter 无损互转，AI 可精确抽取与检索事实； - 自动生成稳定I…