プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

MCP Local Rag

作者:damoqiongqiuバージョン 0.21.0i★ 13iパソコンで動くリポジトリ ↗
レジストリ名io.github.damoqiongqiu/mcp-local-rag

インストール方法

What it does

Semantic code & doc search with keyword boost. AST code nav, auto HF mirror, local, privacy-first.

  • Connects パソコンで動く
  • Account or key No key needed · 1 setting to fill in (HTTPS_PROXY)
  • Category 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6381 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6051 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2361 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気14/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ3/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア17/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

MCP Local Rag をインストールして。https://mcp.popnx.com/i/damoqiongqiu-mcp-local-rag.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server MCP Local Rag を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "local-rag": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-rag" ], "env": { "HTTPS_PROXY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) HTTPS_PROXY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Local Rag のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HTTPS_PROXY HTTPS proxy URL for downloading embedding models (e.g. http://proxy:8080). Required only if behind a corporate proxy.

    説明は英語の原文のままです。

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "local-rag": {
          "command": "npx",
          "args": [
            "-y",
            "@damoqiongqiu/mcp-local-rag"
          ],
          "env": {
            "HTTPS_PROXY": "your-value"
          }
        }
      }
    }
  5. Claude を終了してもう一度開く

  6. 試してみる

    MCP Local Rag を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が MCP Local Rag を使っていると言うか、回答に MCP Local Rag のツール名が出れば接続成功です

追加の設定 17 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • BASE_DIR ドキュメント保存用のベースディレクトリ(デフォルトは現在の作業ディレクトリ)。BASE_DIRS が設定されている場合は無視されます。
    英語の原文を見るBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
  • BASE_DIRS 基本ディレクトリの JSON 配列(例: '"/a","/b"')。BASE_DIR より優先されます。
    英語の原文を見るJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
  • DB_PATH LanceDB データベースディレクトリへのパス(デフォルトは ./lancedb/)
    英語の原文を見るPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIR Transformers.js のモデルをキャッシュするディレクトリ(デフォルトは ./models/)
    英語の原文を見るDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAME 埋め込みモデル名(デフォルトは Xenova/all-MiniLM-L6-v2)
    英語の原文を見るEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • MAX_FILE_SIZE 最大ファイルサイズ(バイト単位)(デフォルトは 104857600 / 100MB)
    英語の原文を見るMaximum file size in bytes (defaults to 104857600 / 100MB)
  • RAG_MAX_DISTANCE Maximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
  • RAG_GROUPING Grouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no gr…
  • RAG_MAX_FILES Maximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. U…
  • CHUNK_MIN_LENGTH チャンクの最小長(文字数、1~10000、既定値は50)。この閾値より短いチャンクは取り込み時に除外されます。
    英語の原文を見るMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
  • RAG_DEVICE Execution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initializ…
  • RAG_DTYPE Embedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the…
  • RAG_HYBRID_WEIGHT Keyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
  • RAG_WATCH 変更を検出し、変更されたファイルを再インデックスする自動ファイルウォッチャーを有効にします(true/1 で有効)。活発な開発中に便利です。
    英語の原文を見るEnable automatic file watcher to detect changes and re-index modified files (true/1 to enable). Useful during active development.
  • HF_ENDPOINT モデルのダウンロードに使用する明示的な HuggingFace エンドポイント URL。設定すると自動ミラー検出はスキップされ、この URL が直接使用されます。機能が完全なミラーがある場合に便利です。
    英語の原文を見るExplicit HuggingFace endpoint URL to use for model downloads. When set, auto-mirror detection is skipped and this URL is used directly. Useful when you have a full-featured mirror.
  • HF_AUTO_MIRROR HuggingFace ダウンロードの自動ミラー検出を有効にします(既定値は true)。"false" または "0" に設定すると無効になり、huggingface.co を直接使用します。ミラーの順序は huggingface.co → hf-mirror.com →…
    英語の原文を見るEnable automatic mirror detection for HuggingFace downloads (defaults to true). Set to "false" or "0" to disable and use huggingface.co directly. The mirror chain is: huggingface.co → hf-mirror.com →…
  • HTTP_PROXY 埋め込みモデルのダウンロードに使用する HTTP プロキシの URL。HTTPS_PROXY が設定されていない場合のフォールバックです。
    英語の原文を見るHTTP proxy URL for downloading embedding models. Fallback if HTTPS_PROXY is not set.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ MCP Local Rag につなげません

MCP Local Rag はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · MCP Local Rag につなげるアプリを使う

  • 設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server MCP Local Rag を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user local-rag --env HTTPS_PROXY=your-value -- npx -y @damoqiongqiu/mcp-local-rag 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) HTTPS_PROXY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Local Rag のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HTTPS_PROXY HTTPS proxy URL for downloading embedding models (e.g. http://proxy:8080). Required only if behind a corporate proxy.

    説明は英語の原文のままです。

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user local-rag --env HTTPS_PROXY=your-value -- npx -y @damoqiongqiu/mcp-local-rag
  5. Claude Code で /mcp と入力

    MCP Local Rag が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    MCP Local Rag を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が MCP Local Rag を使っていると言うか、回答に MCP Local Rag のツール名が出れば接続成功です

追加の設定 17 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • BASE_DIR ドキュメント保存用のベースディレクトリ(デフォルトは現在の作業ディレクトリ)。BASE_DIRS が設定されている場合は無視されます。
    英語の原文を見るBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
  • BASE_DIRS 基本ディレクトリの JSON 配列(例: '"/a","/b"')。BASE_DIR より優先されます。
    英語の原文を見るJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
  • DB_PATH LanceDB データベースディレクトリへのパス(デフォルトは ./lancedb/)
    英語の原文を見るPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIR Transformers.js のモデルをキャッシュするディレクトリ(デフォルトは ./models/)
    英語の原文を見るDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAME 埋め込みモデル名(デフォルトは Xenova/all-MiniLM-L6-v2)
    英語の原文を見るEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • MAX_FILE_SIZE 最大ファイルサイズ(バイト単位)(デフォルトは 104857600 / 100MB)
    英語の原文を見るMaximum file size in bytes (defaults to 104857600 / 100MB)
  • RAG_MAX_DISTANCE Maximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
  • RAG_GROUPING Grouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no gr…
  • RAG_MAX_FILES Maximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. U…
  • CHUNK_MIN_LENGTH チャンクの最小長(文字数、1~10000、既定値は50)。この閾値より短いチャンクは取り込み時に除外されます。
    英語の原文を見るMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
  • RAG_DEVICE Execution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initializ…
  • RAG_DTYPE Embedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the…
  • RAG_HYBRID_WEIGHT Keyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
  • RAG_WATCH 変更を検出し、変更されたファイルを再インデックスする自動ファイルウォッチャーを有効にします(true/1 で有効)。活発な開発中に便利です。
    英語の原文を見るEnable automatic file watcher to detect changes and re-index modified files (true/1 to enable). Useful during active development.
  • HF_ENDPOINT モデルのダウンロードに使用する明示的な HuggingFace エンドポイント URL。設定すると自動ミラー検出はスキップされ、この URL が直接使用されます。機能が完全なミラーがある場合に便利です。
    英語の原文を見るExplicit HuggingFace endpoint URL to use for model downloads. When set, auto-mirror detection is skipped and this URL is used directly. Useful when you have a full-featured mirror.
  • HF_AUTO_MIRROR HuggingFace ダウンロードの自動ミラー検出を有効にします(既定値は true)。"false" または "0" に設定すると無効になり、huggingface.co を直接使用します。ミラーの順序は huggingface.co → hf-mirror.com →…
    英語の原文を見るEnable automatic mirror detection for HuggingFace downloads (defaults to true). Set to "false" or "0" to disable and use huggingface.co directly. The mirror chain is: huggingface.co → hf-mirror.com →…
  • HTTP_PROXY 埋め込みモデルのダウンロードに使用する HTTP プロキシの URL。HTTPS_PROXY が設定されていない場合のフォールバックです。
    英語の原文を見るHTTP proxy URL for downloading embedding models. Fallback if HTTPS_PROXY is not set.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server MCP Local Rag を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "local-rag": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-rag" ], "env": { "HTTPS_PROXY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) HTTPS_PROXY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Local Rag のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HTTPS_PROXY HTTPS proxy URL for downloading embedding models (e.g. http://proxy:8080). Required only if behind a corporate proxy.

    説明は英語の原文のままです。

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    MCP Local Rag の設定で HTTPS_PROXY が空です。自分のキーを入れて保存します

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    MCP Local Rag を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が MCP Local Rag を使っていると言うか、回答に MCP Local Rag のツール名が出れば接続成功です

追加の設定 17 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • BASE_DIR ドキュメント保存用のベースディレクトリ(デフォルトは現在の作業ディレクトリ)。BASE_DIRS が設定されている場合は無視されます。
    英語の原文を見るBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
  • BASE_DIRS 基本ディレクトリの JSON 配列(例: '"/a","/b"')。BASE_DIR より優先されます。
    英語の原文を見るJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
  • DB_PATH LanceDB データベースディレクトリへのパス(デフォルトは ./lancedb/)
    英語の原文を見るPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIR Transformers.js のモデルをキャッシュするディレクトリ(デフォルトは ./models/)
    英語の原文を見るDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAME 埋め込みモデル名(デフォルトは Xenova/all-MiniLM-L6-v2)
    英語の原文を見るEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • MAX_FILE_SIZE 最大ファイルサイズ(バイト単位)(デフォルトは 104857600 / 100MB)
    英語の原文を見るMaximum file size in bytes (defaults to 104857600 / 100MB)
  • RAG_MAX_DISTANCE Maximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
  • RAG_GROUPING Grouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no gr…
  • RAG_MAX_FILES Maximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. U…
  • CHUNK_MIN_LENGTH チャンクの最小長(文字数、1~10000、既定値は50)。この閾値より短いチャンクは取り込み時に除外されます。
    英語の原文を見るMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
  • RAG_DEVICE Execution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initializ…
  • RAG_DTYPE Embedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the…
  • RAG_HYBRID_WEIGHT Keyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
  • RAG_WATCH 変更を検出し、変更されたファイルを再インデックスする自動ファイルウォッチャーを有効にします(true/1 で有効)。活発な開発中に便利です。
    英語の原文を見るEnable automatic file watcher to detect changes and re-index modified files (true/1 to enable). Useful during active development.
  • HF_ENDPOINT モデルのダウンロードに使用する明示的な HuggingFace エンドポイント URL。設定すると自動ミラー検出はスキップされ、この URL が直接使用されます。機能が完全なミラーがある場合に便利です。
    英語の原文を見るExplicit HuggingFace endpoint URL to use for model downloads. When set, auto-mirror detection is skipped and this URL is used directly. Useful when you have a full-featured mirror.
  • HF_AUTO_MIRROR HuggingFace ダウンロードの自動ミラー検出を有効にします(既定値は true)。"false" または "0" に設定すると無効になり、huggingface.co を直接使用します。ミラーの順序は huggingface.co → hf-mirror.com →…
    英語の原文を見るEnable automatic mirror detection for HuggingFace downloads (defaults to true). Set to "false" or "0" to disable and use huggingface.co directly. The mirror chain is: huggingface.co → hf-mirror.com →…
  • HTTP_PROXY 埋め込みモデルのダウンロードに使用する HTTP プロキシの URL。HTTPS_PROXY が設定されていない場合のフォールバックです。
    英語の原文を見るHTTP proxy URL for downloading embedding models. Fallback if HTTPS_PROXY is not set.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

設定を 1 項目入力 (HTTPS_PROXY) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server MCP Local Rag を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "local-rag": { "type": "stdio", "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-rag" ], "env": { "HTTPS_PROXY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) HTTPS_PROXY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Local Rag のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HTTPS_PROXY HTTPS proxy URL for downloading embedding models (e.g. http://proxy:8080). Required only if behind a corporate proxy.

    説明は英語の原文のままです。

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    MCP Local Rag の設定で HTTPS_PROXY が空です。自分のキーを入れて保存します

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    MCP Local Rag を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が MCP Local Rag を使っていると言うか、回答に MCP Local Rag のツール名が出れば接続成功です

追加の設定 17 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • BASE_DIR ドキュメント保存用のベースディレクトリ(デフォルトは現在の作業ディレクトリ)。BASE_DIRS が設定されている場合は無視されます。
    英語の原文を見るBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
  • BASE_DIRS 基本ディレクトリの JSON 配列(例: '"/a","/b"')。BASE_DIR より優先されます。
    英語の原文を見るJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
  • DB_PATH LanceDB データベースディレクトリへのパス(デフォルトは ./lancedb/)
    英語の原文を見るPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIR Transformers.js のモデルをキャッシュするディレクトリ(デフォルトは ./models/)
    英語の原文を見るDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAME 埋め込みモデル名(デフォルトは Xenova/all-MiniLM-L6-v2)
    英語の原文を見るEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • MAX_FILE_SIZE 最大ファイルサイズ(バイト単位)(デフォルトは 104857600 / 100MB)
    英語の原文を見るMaximum file size in bytes (defaults to 104857600 / 100MB)
  • RAG_MAX_DISTANCE Maximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
  • RAG_GROUPING Grouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no gr…
  • RAG_MAX_FILES Maximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. U…
  • CHUNK_MIN_LENGTH チャンクの最小長(文字数、1~10000、既定値は50)。この閾値より短いチャンクは取り込み時に除外されます。
    英語の原文を見るMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
  • RAG_DEVICE Execution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initializ…
  • RAG_DTYPE Embedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the…
  • RAG_HYBRID_WEIGHT Keyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
  • RAG_WATCH 変更を検出し、変更されたファイルを再インデックスする自動ファイルウォッチャーを有効にします(true/1 で有効)。活発な開発中に便利です。
    英語の原文を見るEnable automatic file watcher to detect changes and re-index modified files (true/1 to enable). Useful during active development.
  • HF_ENDPOINT モデルのダウンロードに使用する明示的な HuggingFace エンドポイント URL。設定すると自動ミラー検出はスキップされ、この URL が直接使用されます。機能が完全なミラーがある場合に便利です。
    英語の原文を見るExplicit HuggingFace endpoint URL to use for model downloads. When set, auto-mirror detection is skipped and this URL is used directly. Useful when you have a full-featured mirror.
  • HF_AUTO_MIRROR HuggingFace ダウンロードの自動ミラー検出を有効にします(既定値は true)。"false" または "0" に設定すると無効になり、huggingface.co を直接使用します。ミラーの順序は huggingface.co → hf-mirror.com →…
    英語の原文を見るEnable automatic mirror detection for HuggingFace downloads (defaults to true). Set to "false" or "0" to disable and use huggingface.co directly. The mirror chain is: huggingface.co → hf-mirror.com →…
  • HTTP_PROXY 埋め込みモデルのダウンロードに使用する HTTP プロキシの URL。HTTPS_PROXY が設定されていない場合のフォールバックです。
    英語の原文を見るHTTP proxy URL for downloading embedding models. Fallback if HTTPS_PROXY is not set.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?MCP Local Rag を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user local-rag --env HTTPS_PROXY=your-value -- npx -y @damoqiongqiu/mcp-local-rag

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "@damoqiongqiu/mcp-local-rag"
      ],
      "env": {
        "HTTPS_PROXY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "@damoqiongqiu/mcp-local-rag"
      ],
      "env": {
        "HTTPS_PROXY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "local-rag": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@damoqiongqiu/mcp-local-rag"
      ],
      "env": {
        "HTTPS_PROXY": "your-value"
      }
    }
  }
}

自分で入力する値

  • BASE_DIR env
    ドキュメント保存用のベースディレクトリ(デフォルトは現在の作業ディレクトリ)。BASE_DIRS が設定されている場合は無視されます。
    英語の原文を見るBase directory for document storage (defaults to current working directory). Ignored when BASE_DIRS is set.
  • BASE_DIRS env
    基本ディレクトリの JSON 配列(例: '"/a","/b"')。BASE_DIR より優先されます。
    英語の原文を見るJSON array of base directories (e.g. '["/a","/b"]'). Takes precedence over BASE_DIR.
  • DB_PATH env
    LanceDB データベースディレクトリへのパス(デフォルトは ./lancedb/)
    英語の原文を見るPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIR env
    Transformers.js のモデルをキャッシュするディレクトリ(デフォルトは ./models/)
    英語の原文を見るDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAME env
    埋め込みモデル名(デフォルトは Xenova/all-MiniLM-L6-v2)
    英語の原文を見るEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • MAX_FILE_SIZE env
    最大ファイルサイズ(バイト単位)(デフォルトは 104857600 / 100MB)
    英語の原文を見るMaximum file size in bytes (defaults to 104857600 / 100MB)
  • RAG_MAX_DISTANCE env
    Maximum distance threshold for filtering search results. Results with distance greater than this value will be excluded. Lower values mean stricter filtering (e.g., 0.5 for high relevance only)
  • RAG_GROUPING env
    Grouping mode for quality filtering. 'similar' returns only the most similar group (stops at first distance jump). 'related' includes related groups (stops at second distance jump). Unset means no gr…
  • RAG_MAX_FILES env
    Maximum number of files to keep in search results. Results are filtered to include only chunks from the top N best-scoring files. For example, 1 returns only the single best-matching file's chunks. U…
  • CHUNK_MIN_LENGTH env
    チャンクの最小長(文字数、1~10000、既定値は50)。この閾値より短いチャンクは取り込み時に除外されます。
    英語の原文を見るMinimum chunk length in characters (1-10000, defaults to 50). Chunks shorter than this threshold are filtered out during ingestion.
  • RAG_DEVICE env
    Execution device for the embedder (defaults to cpu). Passed straight to ONNX Runtime; see the Transformers.js device source for the supported backend names. If the requested device fails to initializ…
  • RAG_DTYPE env
    Embedding quantization dtype for the embedder (defaults to fp32). Opt-in and pass-through; accepts any dtype the chosen model provides (fp32, fp16, q8, int8, ...). If the model has no variant for the…
  • RAG_HYBRID_WEIGHT env
    Keyword boost factor for hybrid search (0.0-1.0, defaults to 0.6). 0 means semantic similarity only; higher values increase the keyword-match contribution to the final score.
  • RAG_WATCH env
    変更を検出し、変更されたファイルを再インデックスする自動ファイルウォッチャーを有効にします(true/1 で有効)。活発な開発中に便利です。
    英語の原文を見るEnable automatic file watcher to detect changes and re-index modified files (true/1 to enable). Useful during active development.
  • HF_ENDPOINT env
    モデルのダウンロードに使用する明示的な HuggingFace エンドポイント URL。設定すると自動ミラー検出はスキップされ、この URL が直接使用されます。機能が完全なミラーがある場合に便利です。
    英語の原文を見るExplicit HuggingFace endpoint URL to use for model downloads. When set, auto-mirror detection is skipped and this URL is used directly. Useful when you have a full-featured mirror.
  • HF_AUTO_MIRROR env
    HuggingFace ダウンロードの自動ミラー検出を有効にします(既定値は true)。"false" または "0" に設定すると無効になり、huggingface.co を直接使用します。ミラーの順序は huggingface.co → hf-mirror.com →…
    英語の原文を見るEnable automatic mirror detection for HuggingFace downloads (defaults to true). Set to "false" or "0" to disable and use huggingface.co directly. The mirror chain is: huggingface.co → hf-mirror.com →…
  • HTTPS_PROXY 必須 env
    HTTPS proxy URL for downloading embedding models (e.g. http://proxy:8080). Required only if behind a corporate proxy.
  • HTTP_PROXY env
    埋め込みモデルのダウンロードに使用する HTTP プロキシの URL。HTTPS_PROXY が設定されていない場合のフォールバックです。
    英語の原文を見るHTTP proxy URL for downloading embedding models. Fallback if HTTPS_PROXY is not set.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
129/週
接続方法
パソコンで動く
最新バージョンi
0.21.0
レジストリ公開日i
2026年7月23日
コードの最終更新i
2026年7月23日
作者
damoqiongqiu
パッケージ
npm: @damoqiongqiu/mcp-local-rag
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント damoqiongqiu で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:4 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @damoqiongqiu/mcp-local-rag@0.21.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/damoqiongqiu-mcp-local-rag.svg)](https://mcp.popnx.com/en/servers/damoqiongqiu-mcp-local-rag)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6416件のうち93%よりスターが多い
  • このカテゴリのほかの6416件のうち21%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6416件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Local Ragは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は4 か月前、最新バージョン(0.21.0)がレジストリに届いたのは4 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万5 日前更新

クラウドで動く✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 52442 か月前更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 199712 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16262 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
MCP Local Rag
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック3/35/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

MCP Local RAG

🍴 Forked from shinpr/mcp-local-rag — original work by Shinsuke Kagawa

Local code intelligence engine for AI coding assistants. AST-level semantic chunking + keyword boost for pinpointing functions, classes, and APIs — fully private, zero setup.

📖 中文文档


Table of Contents

  1. Features
  2. Quick Start
  • 2.1 Configure Your AI Coding Tool
  • 2.2 CLI Quick Start
  • 2.3 First-Time Project Indexing
  1. Core Concepts
  • 3.1 Dual-Strategy Chunking
  • 3.2 Hybrid Search
  • 3.3 Security Boundary
  1. MCP Tool Reference
  • 4.1 Ingest Tools
  • 4.2 Search Tools
  • 4.3 Management Tools
  • 4.4 Code Intelligence
  • 4.5 System Tools
  1. CLI
  • 5.1 Basic Commands
  • 5.2 CLI Configuration
  1. Network & Models
  • 6.1 Mirror Auto-Detection
  • 6.2 Model Selection
  • 6.3 File Watching
  1. Search Tuning
  2. Performance Tuning
  • 8.1 Quantization Precision
  • 8.2 Execution Device
  • 8.3 Minimum Chunk Length
  • 8.4 Recommended Configurations
  1. Configuration Reference
  2. Troubleshooting
  3. Development

1. Features

  • Smart dual-strategy chunking — AST-level code chunking via tree-sitter (splits at function/class/method boundaries, injects scope chain + imports). Semantic chunking for documents (splits by meaning, not character count).
  • Semantic search + keyword boost — Vector search first, then keyword matching boosts exact terms. useEffect, error codes, class names rank higher — not just semantically guessed.
  • 15 MCP tools — Ingest, search, manage, code intelligence, and system ops in one server.
  • AST code intelligence — find_definition and find_references for IDE-level code navigation, powered by tree-sitter metadata captured at ingest time.
  • Three-tier mirror auto-fallback — huggingface.co → hf-mirror.com → modelscope.cn, zero config for users in mainland China.
  • Runs entirely locally — No API keys, no cloud, no data leaving your machine. Works offline after the first model download.
  • Zero-friction setup — One npx command. No Docker, Python, or servers to manage.

2. Quick Start

Set BASE_DIR to the folder you want to search (BASE_DIRS for multiple roots — see Configuration).

2.1 Configure Your AI Coding Tool

Cursor — ~/.cursor/mcp.json:

{

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

Claude Code:

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

Codex — ~/.codex/config.toml:

[mcp_servers.local-rag]

command = "npx" args = ["-y", "@damoqiongqiu/mcp-local-rag"]

[mcp_servers.local-rag.env] BASE_DIR = "/path/to/your/project"

WorkBuddy — Settings → Custom Connectors → Add:

{

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

⚠️ WorkBuddy: you MUST click "Trust" in the Custom Connectors list after adding, otherwise the server is silently blocked.

2.2 CLI Quick Start

No MCP needed — run directly from the terminal:

npx @damoqiongqiu/mcp-local-rag ingest ./src/

npx @damoqiongqiu/mcp-local-rag query "auth middleware" npx @damoqiongqiu/mcp-local-rag status

That's it. No Docker, Python, or server setup.

2.3 First-Time Project Indexing
You: "Index the src directory of this project"

Assistant: Successfully ingested 156 files (2,847 chunks created)

You: "Where's the middleware that handles API rate limiting?" Assistant: src/middleware/rateLimiter.ts — useRateLimiter(), lines 42–89

You: "How is the database connection pool configured?" Assistant: src/config/database.ts — createPool() default max: 20, idle: 5


3. Core Concepts

3.1 Dual-Strategy Chunking

Chunking strategy is chosen per file type:

  • Code files (50+ languages) — CodeChunker parses source via tree-sitter AST, splits at structural boundaries (functions, classes, methods). Each chunk's contextualizedText includes its scope chain and import context for precise semantic search.
  • Documents (PDF/DOCX/TXT/MD/HTML) — SemanticChunker splits into sentences, groups by embedding similarity to find natural topic boundaries. Markdown code blocks remain intact — never split mid-block.
3.2 Hybrid Search

Search = semantic similarity + keyword boost (RAG_HYBRID_WEIGHT, default 0.6):

  1. Query vectorization → semantic search finds most relevant chunks
  2. Quality filters apply (distance threshold, grouping)
  3. Keyword matching boosts exact-term rankings

Exact identifiers like useEffect are never buried by semantic approximations.

3.3 Security Boundary

Only files under BASE_DIR / BASE_DIRS are accessible for ingest, list, delete, or read-neighbor operations. Symlinks resolved outside roots are rejected. Sibling-prefix paths (e.g., /foo/barista when root is /foo/bar) are also blocked — prevents path traversal attacks.


4. MCP Tool Reference

15 tools organized into 5 categories.

4.1 Ingest Tools
#ToolPurposeExample
1ingest_fileSingle file (PDF/DOCX/TXT/MD/code)"Ingest ./docs/api-spec.pdf"
2ingest_dataIn-memory text/HTML"Fetch this page and ingest the HTML"
3ingest_directoryBulk directory ingest"Ingest everything under ./src"

`ingest_file` supports 50+ code languages. PDFs support an optional visual mode — a local VLM generates captions for figure pages, making visual content searchable. Two profiles available:

ProfileModelCacheSuited for
fast (default)SmolVLM-256M~250 MBLight visual indexing
qualityQwen2.5-VL-3B-ONNX~2.9 GBFigures with in-image text
# CLI

npx @damoqiongqiu/mcp-local-rag ingest ./spec.pdf --visual --visual-quality quality

MCP

"Ingest ./spec.pdf with visual: true, visualQuality: 'quality'"

`ingest_data` runs Readability → Markdown → index. Perfect for web content fetched by your AI assistant. Re-ingesting replaces old versions automatically.

`ingest_directory` scans recursively, respects .gitignore, shows real-time progress via MCP notifications.

4.2 Search Tools
#ToolPurposeKey Parameters
4query_documentsHybrid search (semantic + keyword)query, limit, scope, highlightContext, fromTimestamp
5read_chunk_neighborsExpand context around resultsfilePath, chunkIndex, before, after

`query_documents` — scope accepts a single path prefix or list, restricting results to that subtree. highlightContext returns snippets around matched terms. fromTimestamp / untilTimestamp enable time-range filtering.

`read_chunk_neighbors` — defaults to 2 chunks before and after (like grep -C 2), max 50 each. Response includes the target chunk marked isTarget: true.

4.3 Management Tools
#ToolPurpose
6list_filesList files with ingestion status (ingested: true/false)
7delete_fileDelete by file path or source URL
8statusIndex stats: docs, chunks, memory, search mode

list_files supports scope filtering with the same prefix-match semantics as search. In large directories, scope accelerates the scan by skipping out-of-scope subtrees.

4.4 Code Intelligence
#ToolPurposeInput
9find_definitionLocate symbol definition (file, line range, scope)Exact symbol name
10find_referencesFind all references (import + text mention)Symbol name

Both tools depend on AST metadata (imports, entities, scope chains) extracted by tree-sitter at ingest time. Only works for code files ingested with `CodeChunker` — files ingested before v0.18.7 lack this metadata and require reindex_all to rebuild.

`find_references` uses a two-phase strategy: (1) exact match in codeMeta.imports → (2) FTS full-text search for the symbol name. Results are deduplicated by (filePath, chunkIndex), with import references listed first.

4.5 System Tools
#ToolPurpose
11configRuntime hot read/write config — no restart needed
12dedup_checkSHA256 + Jaccard similarity to detect duplicate files
13export_indexExport entire index as JSON (backup or migration)
14reindex_allFull re-chunk + re-embed (after model change)
15reindex_staleRe-ingest only files modified on disk (incremental sync)

`config` hot-swaps hybridWeight, modelName, cacheDir, baseDir/baseDirs, etc. Switching models auto-disposes the old Embedder and initializes the new one — note: changing models alters the embedding space and requires reindex_all.

`dedup_check` is especially useful in monorepos — spot ↔ futures mirror code is typically flagged with similarity 1.0.


5. CLI

5.1 Basic Commands
# Ingest

npx @damoqiongqiu/mcp-local-rag ingest ./src/

Search (with scope)

npx @damoqiongqiu/mcp-local-rag query "auth middleware" npx @damoqiongqiu/mcp-local-rag query "auth" --scope /docs/api

Context expansion

npx @damoqiongqiu/mcp-local-rag read-neighbors --file-path /abs/path.md --chunk-index 5

Management

npx @damoqiongqiu/mcp-local-rag list --scope /docs/api npx @damoqiongqiu/mcp-local-rag status npx @damoqiongqiu/mcp-local-rag delete ./docs/old.pdf npx @damoqiongqiu/mcp-local-rag delete --source "https://..."

query, read-neighbors, list, status, delete emit JSON to stdout (pipe to jq). ingest emits progress to stderr.

Global options (--db-path, --cache-dir, --model-name) go before the subcommand:

npx @damoqiongqiu/mcp-local-rag --help

⚠️ The CLI does NOT read your MCP client config (mcp.json, etc.). Configure via flags or environment variables.

5.2 CLI Configuration

Flags — global options before, subcommand options after:

npx @damoqiongqiu/mcp-local-rag --db-path ./my-db query "auth" --base-dir ./docs

`--base

冒頭だけを表示しています。続きはリポジトリで読めます