knowledge-rag

適用於 Claude Code、Cursor 及其他 MCP 用戶端的本地 RAG 伺服器:預設啟用混合 BM25 + 向量搜尋與交叉編碼器重新排序,13 個 MCP 工具,33 種檔案類型

knowledge-rag 是什麼?

適用於 Claude Code、Cursor 及其他 MCP 用戶端的本地 RAG 伺服器:預設啟用混合 BM25 + 向量搜尋與交叉編碼器重新排序,13 個 MCP 工具,33 種檔案類型(包含程式碼),並在檔案變更時自動重新索引。單一 Python 程序,內嵌 ChromaDB 與 FastEmbed ONNX:無需 Docker、資料庫伺服器或 API 金鑰;首次模型下載後可離線使用。

knowledge-rag 概覽

這是什麼

knowledge-rag 是一個以 MCP 為原生協定的本地 RAG 伺服器,支援 Claude Code、Cursor、Windsurf、VS Code、Cline、Gemini CLI 與 Zed 等 AI 代理。它提供混合搜尋(語意 + BM25)、交叉編碼器重新排序,以及 13 個 MCP 工具。可解析 35 種檔案格式。所有處理完全在本地執行,無需外部伺服器或 API 金鑰。內建可選的 Bearer 認證、Prometheus 指標、速率限制、健康檢查、結構化 JSON 日誌與基於階段的重新建置。專案採用 MIT 授權,為開放原始碼。

主要功能

  • 混合搜尋:結合語意嵌入與 BM25 檢索 - 交叉編碼器重新排序,提升結果相關性 - 13 個 MCP 工具,可與 AI 客戶端整合 - 解析 35 種檔案格式(PDF、Markdown、程式碼等) - 100% 本地處理:嵌入生成、索引與檢索皆在裝置上執行 - 無需外部伺服器或 API 金鑰;首次模型下載後可離線使用 - 生產級功能:Bearer 認證、Prometheus 指標、速率限制、健康檢查、結構化 JSON 日誌

使用情境

  • 為 AI 程式碼輔助工具(Claude Code、Cursor 等)提供本地文件問答與檢索 - 在不將資料傳送至雲端的情況下,搜尋專有或敏感文件的知識庫 - 透過 HTTP/SSE 傳輸協定,提供具認證與速率限制的多使用者共享 RAG 伺服器 - 使用 Docker 搭配預先下載的模型進行氣隙或離線部署

快速開始

bash pip install knowledge-rag knowledge-rag init # 建立 config.yaml 與 documents/ 將 PDF、Markdown、程式碼檔案放入 documents/。重新啟動 MCP 客戶端,然後詢問:search_knowledge('your query')。首次查詢會下載 ONNX 嵌入模型(約 200MB),後續查詢會快取。

授權與價格

MIT 授權。開放原始碼。無付費功能。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/lyonzinknowledge-rag.svg)](https://yunodb.com/tools/lyonzinknowledge-rag?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/lyonzinknowledge-rag?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/lyonzinknowledge-rag.svg" alt="Featured on YunoDB" height="20"></a>