shinpr/mcp-local-rag
Local-first RAG server for developers. Semantic + keyword search for code and technical docs. Works with MCP or CLI. Fully private, zero setup.
解决的问题
它提供了一种搜索私人本地文档（PDF、DOCX、Markdown 和文本文件）的方法，无需将数据发送到外部嵌入 API。它允许 AI 助手或用户通过终端对本地文件执行语义和关键字搜索，同时确保数据保持离线状态。
运作方式
该项目使用 Model Context Protocol (MCP) 实现了一个本地检索增强生成 (RAG) 系统。它会索引指定本地目录中的文档，结合语义相似度（通过本地嵌入模型）与技术术语的关键字匹配。它可以集成到支持 MCP 的客户端（如 Claude Code、Cursor 或 Codex），或作为独立的 CLI 工具使用。它支持本地模型缓存，并可选择使用本地视觉模型为 PDF 图表生成说明文字。
目标对象
- 需要离线搜索私人文档的开发者与研究人员。
- 希望让 AI 代理访问本地知识库的 MCP 兼容 AI 客户端用户。
- 偏好本地优先 AI 工具以避免 API 成本与隐私顾虑的人士。
特色亮点
- 完全本地化：无需 API 密钥、Docker 或外部数据库；模型下载完成后，摄取与搜索皆可离线运作。
- 混合搜索：结合语义意图与 API 名称及错误代码的精确关键字匹配。
- 广泛格式支持：索引 PDF、DOCX、Markdown 和文本文件。
- MCP 集成：通过 Model Context Protocol 无缝连接至 AI 代理。
- 视觉能力：可选的 PDF 图表本地说明文字生成功能，使其可被搜索。
相关
- 项目
- Dispatch
- 项目
- Dispatch
- 项目