非公開の文書を外部APIに送らず検索できる「MCP Local RAG」
- 公開
- 正式公開 2025-10-31
- 作り手
- shinpr(個人)
- 対応
- MCP サーバー(npm)・CLI(Node.js)
- 価格
- 無料(MIT ライセンス)
- 評価
- GitHub のスター 414(2026-10-14)
どんなアプリか
mcp-local-rag は、手元にある PDF・DOCX・Markdown・テキストファイルを索引化し、MCP クライアントやターミナルから検索できるようにするツールです。文書を埋め込み API に送らずに検索できる、と README で説明されています。
Local-first RAG server for developers. Semantic + keyword search for code and technical docs. Works with MCP or CLI. Fully private, zero setup.
shinpr さん、GitHub リポジトリの説明
検索は意味の近さとキーワードの一致を組み合わせる方式で、質問の意図にも、API 名・クラス名・エラーコードのような技術用語そのものにも当たるようにしています。結果には元の文の箇所と、取れる場合は見出し・行番号・ページ番号が付くので、元の文書を確かめて引用できます。
MCP クライアントには npx -y mcp-local-rag を登録し、検索したい文書のフォルダを BASE_DIR に指定して使います。MCP クライアントを使わない場合は、npx mcp-local-rag ingest で取り込み、npx mcp-local-rag query で検索する CLI としても使えます。
料金とデータの置き場所
MIT ライセンスで公開されており、個人利用でも商用利用でも無料です。
API キー、Docker、Python、外部のデータベースは要りません。初回にモデルを取得したあとは、文書の取り込みと検索はオフラインで動きます。索引はローカルのベクトルデータベース(既定は ./lancedb/)に保存され、バックアップは書き込み中でないときに DB_PATH のフォルダをコピーして取ります。
ただし、検索結果を並べ替える外部コマンド(RAG_RERANK_CMD)を設定し、そのコマンドがリモートのサービスを呼ぶ場合は、一致した文が手元から出ることがあると README に書かれています。
同じ分野のアプリ
| 名前 | 型 | 仕掛け | 対応 | 料金 |
|---|---|---|---|---|
| MCP Local RAG | ローカル文書検索 | 手元の PDF・DOCX・Markdown をローカルで索引化し、意味とキーワードで検索 | MCP サーバー(npm)/CLI | 無料(OSS, MIT) |
| Inkdrop MCP Server | ノート連携 | Markdown ノートアプリ Inkdrop のローカル API を AI から使える公式 MCP サーバー | Node.js | 無料(OSS, Apache-2.0) |
| Sub-Agents MCP Server | エージェント定義 | サブエージェントを Markdown で定義し、どの MCP クライアントからでも呼び出せる | MCP サーバー(npm) | 無料(OSS, MIT) |
| Tsumugu | ドキュメントサイト | docs フォルダに文書を置くと目次と全文検索つきのドキュメントサイトになる | CLI | 無料(未確認) |
入れる前に
Node.js 22 以降が必要です。初回は npm パッケージと埋め込みモデルの取得にインターネット接続が要り、既定のモデルは約 90 MB で、取り込みが始まるまで1〜2分かかることがあります。
Excel、PowerPoint、単体の画像ファイル、ソースコードの拡張子のファイルは取り込めません。PDF の図はローカルの画像モデルで説明文を付けられますが、OCR や画像検索ではありません。
サーバーは一人のローカル利用を想定しており、認証やアクセス制御はありません。同じ DB_PATH に複数の CLI や MCP から同時に書き込まないよう注意書きがあります。埋め込みモデルを変えるときは、新しい DB_PATH に索引を作り直す必要があります。