KuraDB

[!NOTE] 此 README 由 SKILL 生成，英文版請參閱這裡。

DROP FILES IN, LET YOUR AGENT SEARCH THEM OUT

Go 唯讀 RAG 資料庫服務，具備拖放自動索引、關鍵字與語意並行搜尋與 MCP 工具介面

目錄

功能特點
架構
授權
Author

功能特點

git clone https://github.com/pardnchiu/KuraDB.git && cd KuraDB && make app · 完整文件

拖放即索引 — 把檔案丟進 ~/Kura_{name} 資料夾，watcher 自動解析 PDF／DOCX／PPTX／CSV／XLSX／純文字並排入 embedding，刪檔即軟刪除。
關鍵字與語意並行搜尋 — 同一請求平行執行 gse 中文斷詞關鍵字比對與 OpenAI embedding 向量搜尋，結果依來源檔分組回傳。
兩階段向量檢索 — 先以來源平均向量篩出候選檔，再對候選區塊平行計算 cosine，並以相似度門檻濾除雜訊。
單向寫入的唯讀邊界 — 對外只有查詢端點，寫入唯一路徑為 watcher → parser → SQLite，內容變更時自動作廢舊向量。
原生 MCP 工具 — kura mcp 以 stdio 提供 list_rag／search_rag，亦可透過 kura remote enable 在 HTTP /mcp 上開放。

架構

完整架構

graph TB
    Inbox[~/Kura_name 資料夾] --> Watcher[檔案監控器]
    Watcher --> SQLite[(每庫 SQLite)]
    SQLite --> Embedder[Embedding 排程器]
    Embedder --> OpenAI[OpenAI Embedding]
    Embedder --> Vector[向量快取]
    HTTP[HTTP API] --> Search[共用搜尋核心]
    MCP[MCP stdio / HTTP] --> Search
    Search --> Vector
    Search --> SQLite

授權

本專案採用 MIT LICENSE。

Author

Just open an issue to share an idea.

kuradb contributors

©️ 2026 邱敬幃 Pardn Chiu

EN