适合谁
- 需要本地运行和隐私保护的开发者
- 搜索代码、技术规格和内部文档的单用户环境
- 希望通过 MCP 或 CLI 使用轻量级 RAG 的用户
M
61FMRS · C
一个 MIT 许可的本地优先开发者 RAG 服务器，提供 stdio MCP 工具和 CLI。其核心特点是本地嵌入、语义分块、关键词增强和基于相关性间隔的结果过滤；适合注重隐私的单用户代码与文档检索。
MCP Local RAG 是面向开发者的本地优先 RAG 服务器，也可作为 CLI 使用。它使用本地嵌入、语义搜索与关键词增强进行代码和技术文档检索，数据默认保留在本机。支持 PDF、DOCX、TXT、Markdown，以及通过 ingest_data 导入的 HTML。
工具能力
query_documents
使用语义相似度和关键词增强搜索已索引文档。
ingest_file
从受支持的本地文件提取文本、分块、生成嵌入并写入本地索引。
ingest_data
将传入的 HTML 或其他数据内容清理并写入本地索引。
read_chunk_neighbors
读取指定搜索结果块前后的相邻块以扩展上下文。
list_files
列出配置目录中的文件及其索引状态。
delete_file
从 RAG 索引中删除文件或数据源。
status
显示 RAG 数据库和系统状态。
sync_start
异步扫描配置目录，重新摄取新增或变更文件并清理已删除文件。
sync_status
查询同步任务的运行状态、进度、摘要、警告或错误。
安装接入
在 MCP 客户端配置中添加该 stdio 服务器，使用 npx -y mcp-local-rag，并通过 BASE_DIR 指定文档根目录；重启客户端后即可使用。首次使用会下载嵌入模型，之后文本摄取和搜索可离线运行。也可直接使用 CLI。
claude_desktop_config.json
{"mcpServers":{"local-rag":{"command":"npx","args":["-y","mcp-local-rag"],"env":{"BASE_DIR":"/path/to/your/documents"}}}}
选型与风险
不适合谁
- 需要多用户访问、身份验证或访问控制的部署
- 需要云端规模化检索或更高云端模型准确率的场景
- 需要 Excel、PowerPoint 或独立图像搜索的场景
所需权限
- 读取配置文档根目录下的受支持文件
- 在 DB_PATH 写入 LanceDB 数据库目录
- 在 CACHE_DIR 写入本地 Transformers.js 模型缓存
- 首次使用时访问网络下载模型；模型缓存后可离线运行
风险与副作用
- 这是面向单用户本地访问的服务器，不提供多用户认证或访问控制
- 视觉模式生成的 PDF 图注可能包含攻击者控制的文本，下游模型应将检索内容视为不可信数据
- 更改嵌入模型、设备或 dtype 后需要删除数据库并重新摄取，否则可能导致搜索质量下降
- 同一 DB_PATH 的摄取、删除和同步应保持单一写入进程
常见排障
- 确认文件已先摄取，并使用 list_files 或 status 检查索引状态
- 首次运行模型下载失败时检查网络连接或代理设置
- 遇到文件过大时检查或调整 MAX_FILE_SIZE
- 遇到路径限制错误时确认路径位于 BASE_DIR、BASE_DIRS 或 CLI 指定的根目录内
- 检查 MCP 配置语法并完全重启客户端；也可直接运行 npx mcp-local-rag 验证启动
使用场景
在本地搜索代码库、API 规范和技术文档
对 PDF、DOCX、TXT 和 Markdown 建立私有检索索引
结合语义搜索与关键词增强查找精确标识符、类名和错误代码
通过同步任务维护本地文档索引
支持客户端
Cursor完整支持
Codex完整支持
Claude Code完整支持