mcp-local-rag

概述

mcp-local-rag 是一个专注于隐私保护的 RAG 解决方案，完全在用户本地机器上运行。它提供语义搜索和关键词增强功能，能够捕捉纯向量搜索可能遗漏的技术术语，如函数名或错误代码。该服务器提供7种工具，包括文档摄取、查询、上下文扩展和文件管理。它支持多种文档格式，包括 PDF、DOCX、TXT 和 Markdown，并可通过 API 摄取 HTML 内容。

试试问 AI

装完之后，这里有 7 个你可以让 AI 做的事：

• ingest_file

  Ingest a document file into the RAG database

  试试:Ingest the document at /Users/me/docs/api-spec.pdf试试:Add the project documentation to the RAG system
• ingest_data

  Ingest HTML content into the RAG database

  试试:Fetch https://example.com/docs and ingest the HTML试试:Process this HTML content I retrieved
• query_documents

  Search documents using semantic similarity with keyword boost

  试试:What does the API documentation say about authentication?试试:Find information about rate limiting试试:Search for error handling best practices
• read_chunk_neighbors

  Read chunks surrounding a specific search result

  试试:That result about authentication looks relevant — read the surrounding chunks试试:Get more context around this result
• list_files

  List all files in BASE_DIR and their ingested status

  试试:List all files in my documents directory试试:Show which files have been ingested
• delete_file

  Delete a file from the RAG database

  试试:Delete old-spec.pdf from RAG试试:Remove this document from the index
• status

  Check RAG server system health and database stats

  试试:Show RAG server status试试:Check how many documents are indexed

可对比工具

安装

{
  "mcpServers": {
    "local-rag": {
      "command": "npx",
      "args": ["-y", "mcp-local-rag"],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}

claude mcp add local-rag --scope user --env BASE_DIR=/path/to/your/documents -- npx -y mcp-local-rag

npx mcp-local-rag ingest ./docs/
npx mcp-local-rag query "authentication API"

FAQ

支持哪些文档格式？

该服务器支持 PDF、DOCX、TXT 和 Markdown 文档。它还可以通过 ingest_data 工具摄取 HTML 内容。

关键词增强如何工作？

关键词增强在语义过滤后应用。它重新排序结果，优先匹配技术术语（如函数名、类名或错误代码）的精确匹配，同时保持语义相关性。

是否有网页界面？

没有，这是一个纯 CLI 和 MCP 服务器解决方案，完全在本地运行，没有网页界面。

mcp-local-rag 对比