andrea9293/mcp-documentation-server

解决的问题

为AI编码代理量身定制的本地优先文档管理和语义搜索系统。无需外部数据库或云API，避免供应商锁定，并通过将知识库离线保存来确保数据隐私。

工作原理

服务器使用 Model Context Protocol (MCP) 向AI代理暴露文档管理和搜索工具。采用「父-子分块」策略，将文档拆分为保留上下文的大块（父块）和用于精确向量搜索的小块（子块）。搜索由 Orama（本地向量数据库）和 Transformers.js（本地嵌入）驱动。还包含一个内置的Web仪表板，用于手动管理文档，并可选集成 Google Gemini 以实现高级AI驱动分析。

适用人群

使用AI编码代理（如 Claude Code、Cursor 或 Gemini CLI）的开发者，希望让其代理访问私有的、本地的文档、PDF和Markdown文件知识库。

主要亮点

• 完全离线：使用本地嵌入和本地向量数据库，确保隐私和速度。
• Web仪表板：包含完整的浏览器端UI，支持上传、浏览和管理文档。
• 混合搜索：结合全文搜索和向量相似性搜索。
• REST API访问：通过REST暴露工具，避免因大型MCP模式而使代理对话上下文膨胀。
• 灵活的文件支持：支持通过拖放上传 .txt、.md 和 .pdf 文件。