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

Vibe Hnindex

作者:AndyAnh174バージョン 0.1.2i★ 3iパソコンで動くリポジトリ ↗
レジストリ名io.github.AndyAnh174/vibe-hnindex

インストール方法

What it does

Index source code into a local knowledge base, search with keyword + semantic + hybrid modes.

  • Connects パソコンで動く
  • Account or key No key needed
  • 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 点満点)で並びます。内訳は次のとおり

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

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

インストール

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

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

Vibe Hnindex をインストールして。https://mcp.popnx.com/i/andyanh174-vibe-hnindex.md に従い、コマンドを見せて、私が OK するまで実行しないで。

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

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

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

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

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

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

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

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

このパソコンの Claude に MCP server Vibe Hnindex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vibe-hnindex": { "command": "npx", "args": [ "-y", "vibe-hnindex" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vibe Hnindex のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

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

    {
      "mcpServers": {
        "vibe-hnindex": {
          "command": "npx",
          "args": [
            "-y",
            "vibe-hnindex"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

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

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

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

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

  • OLLAMA_URL Ollama の埋め込み(embedding)サーバーの URL
    英語の原文を見るOllama embedding server URL
  • OLLAMA_MODEL Ollama の埋め込みモデル名(デフォルト:bge-m3:567m)
    英語の原文を見るOllama embedding model name (default: bge-m3:567m)
  • QDRANT_URL Qdrant ベクトルデータベースの URL
    英語の原文を見るQdrant vector database URL
  • STORAGE_PATH SQLite データベースの保存パス。
    英語の原文を見るSQLite database storage path

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

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

ChatGPT はまだ Vibe Hnindex につなげません

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

代わりにできること

A · Vibe Hnindex につなげるアプリを使う

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

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

このパソコンの Claude Code に MCP server Vibe Hnindex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user vibe-hnindex -- npx -y vibe-hnindex 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vibe Hnindex のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. ターミナルを開く

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

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

    claude mcp add --scope user vibe-hnindex -- npx -y vibe-hnindex
  4. Claude Code で /mcp と入力

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

  5. 試してみる

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

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

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

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

  • OLLAMA_URL Ollama の埋め込み(embedding)サーバーの URL
    英語の原文を見るOllama embedding server URL
  • OLLAMA_MODEL Ollama の埋め込みモデル名(デフォルト:bge-m3:567m)
    英語の原文を見るOllama embedding model name (default: bge-m3:567m)
  • QDRANT_URL Qdrant ベクトルデータベースの URL
    英語の原文を見るQdrant vector database URL
  • STORAGE_PATH SQLite データベースの保存パス。
    英語の原文を見るSQLite database storage path

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

このパソコンの Cursor に MCP server Vibe Hnindex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "vibe-hnindex": { "command": "npx", "args": [ "-y", "vibe-hnindex" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vibe Hnindex のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. このボタンで Cursor を開く

    Cursor で開く

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

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

  4. 試してみる

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

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

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

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

  • OLLAMA_URL Ollama の埋め込み(embedding)サーバーの URL
    英語の原文を見るOllama embedding server URL
  • OLLAMA_MODEL Ollama の埋め込みモデル名(デフォルト:bge-m3:567m)
    英語の原文を見るOllama embedding model name (default: bge-m3:567m)
  • QDRANT_URL Qdrant ベクトルデータベースの URL
    英語の原文を見るQdrant vector database URL
  • STORAGE_PATH SQLite データベースの保存パス。
    英語の原文を見るSQLite database storage path

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

このパソコンの VS Code に MCP server Vibe Hnindex を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "vibe-hnindex": { "type": "stdio", "command": "npx", "args": [ "-y", "vibe-hnindex" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Vibe Hnindex のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. このボタンで VS Code を開く

    VS Code で開く

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

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

  4. 試してみる

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

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

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

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

  • OLLAMA_URL Ollama の埋め込み(embedding)サーバーの URL
    英語の原文を見るOllama embedding server URL
  • OLLAMA_MODEL Ollama の埋め込みモデル名(デフォルト:bge-m3:567m)
    英語の原文を見るOllama embedding model name (default: bge-m3:567m)
  • QDRANT_URL Qdrant ベクトルデータベースの URL
    英語の原文を見るQdrant vector database URL
  • STORAGE_PATH SQLite データベースの保存パス。
    英語の原文を見るSQLite database storage path

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

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

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

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

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

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

パソコンにインストール

Claude Code

claude mcp add --scope user vibe-hnindex -- npx -y vibe-hnindex

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "vibe-hnindex": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-hnindex"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "vibe-hnindex": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-hnindex"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "vibe-hnindex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vibe-hnindex"
      ]
    }
  }
}

自分で入力する値

  • OLLAMA_URL env
    Ollama の埋め込み(embedding)サーバーの URL
    英語の原文を見るOllama embedding server URL
  • OLLAMA_MODEL env
    Ollama の埋め込みモデル名(デフォルト:bge-m3:567m)
    英語の原文を見るOllama embedding model name (default: bge-m3:567m)
  • QDRANT_URL env
    Qdrant ベクトルデータベースの URL
    英語の原文を見るQdrant vector database URL
  • STORAGE_PATH env
    SQLite データベースの保存パス。
    英語の原文を見るSQLite database storage path

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

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

ひと目でわかる

週あたりのダウンロードi
112/週
ライセンスi
ライセンスの記載なし
接続方法
パソコンで動く
最新バージョンi
0.1.2
レジストリ公開日i
2026年4月6日
コードの最終更新i
2026年10月23日
作者
AndyAnh174
パッケージ
npm: vibe-hnindex
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。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アカウント AndyAnh174 で確認済みです

  • ✓ 合格

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

    コードの最終更新:27 日前

  • ! 注意

    ライセンスがある

    GitHubがライセンスの種類を判別できませんでした。ファイルを開いて確認してください

  • – 対象外

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

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

  • – 対象外

    OAuthでサインイン

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

  • … 未チェック

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

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

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

OSV.dev に vibe-hnindex@0.1.2 の登録はありません

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

確認していること → · JSON

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

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

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/andyanh174-vibe-hnindex.svg)](https://mcp.popnx.com/en/servers/andyanh174-vibe-hnindex)

話し合い

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

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

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

ログインして投稿

ユーザーレビュー

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

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

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

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

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

よくある質問

Vibe Hnindexは安全ですか?

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

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

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

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

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

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

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

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

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成長中★ 16282 か月前更新

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

作者のREADME

READMEを開く

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

vibe-hnindex

Local MCP server — index your repo once, search it in every AI session

*Keyword (SQLite FTS5) · Semantic (Qdrant + configurable embeddings) · Hybrid — local or cloud embedding providers*

Current release: v0.16.1 · MCP server vibe-hnindex · installer hnindex-cli. Release notes

Docs · Changelog · npm server · npm CLI


What this does

vibe-hnindex is a Model Context Protocol server. After you index a folder once, assistants (Claude, Cursor, Windsurf, Antigravity, …) can search that codebase with paths and line ranges — data is stored locally (SQLite + optional Qdrant). Embeddings use Ollama (default), OpenAI, Voyage, Gemini, or an OpenAI-compatible API; see Embedding providers. Cloud providers receive the content being embedded; vectors use Qdrant (Docker, local, or Qdrant Cloud with QDRANT_API_KEY).


Documentation

Source security review: security_audit, security_context and pentest_plan provide live source evidence and validation checks. Optional Voyage/HTTP rerank follows server configuration; rerank:false keeps review local. Results are heuristic review leads with explicit coverage, not confirmed vulnerability reports.

📚 Full docs site: [docs.hnindex.cloud](https://docs.hnindex.cloud) — 16 pages covering Getting Started, Configuration, Tools Reference, Guides, and Code Agent.

PageWhat you'll learn
IntroductionWhat vibe-hnindex does, key features, how it works
InstallationNode, Ollama, Qdrant setup + MCP config
Quick Start5-minute walkthrough with CLI + agent skill
ConfigurationAll 25+ env vars with embedding model comparison
Search6 search modes, regex, fuzzy, streaming, cache
Code Agent 🆕code_session + code_apply with safety scopes
Setup MCPPer-platform config (Claude, Cursor, Antigravity, VS Code...)

Also available in-repo: docs/getting-started.md, docs/configuration.md, docs/tools-reference.md.


CLI installer (hnindex)

Optional — writes MCP JSON or Codex TOML for you (merge-safe, same npx -y vibe-hnindex block as in the docs):

npm install -g hnindex-cli

Setup MCP config

hnindex init --mcp antigravity # or: claude, cursor, windsurf, vscode, codex hnindex init --list # show all targets and paths

Install AI agent skill (recommended)

hnindex init-skill --target claude # or: antigravity, cursor, windsurf, vscode hnindex init-skill --list # show all skill targets

Update

hnindex update # npm update -g hnindex-cli

See [docs.hnindex.cloud](https://docs.hnindex.cloud) for full documentation.


Install in 5 steps

  1. Node.js — v22+ (nodejs.org). CI verifies Node 22 and 24. SQLite uses N-API binaries bundled for supported platforms; see Troubleshooting → Windows if npm i vibe-hnindex fails.
  2. Embedding provider — choose OpenAI, Voyage, Gemini or a compatible API, or use local Ollama: install from ollama.com, then: ollama pull bge-m3:567m and keep ollama serve running (or set OLLAMA_URL to a remote server).
  3. Qdrant — for semantic/hybrid search: docker run -d --name qdrant -p 6333:6333 qdrant/qdrant (or use Qdrant Cloud). Keyword-only search works without Qdrant.
  4. MCP config — add the server to your assistant’s MCP settings. Minimal example (self-hosted Qdrant):
{

"mcpServers": { "vibe-hnindex": { "command": "npx", "args": ["-y", "vibe-hnindex"], "env": { "OLLAMA_URL": "http://localhost:11434", "OLLAMA_MODEL": "bge-m3:567m", "QDRANT_URL": "http://localhost:6333", "SEARCH_STREAM_ENABLED": "true", "CODE_AGENT_ENABLED": "true", "CODE_AGENT_SCOPE": "moderate", "CHAT_MEMORY_ENABLED": "true" } } } }

  1. Restart the IDE or assistant, then in chat ask to index a path and search — see First steps.

For Qdrant Cloud, add QDRANT_API_KEY and set QDRANT_URL to your HTTPS cluster URL — details in Getting started.

Agent Workspace

workspace_context identifies the active project purpose, Git/index state and a declared task persisted per project/session. locate_code finds files/symbols then keywords locally, returning line evidence and freshness. Explicit hybrid mode uses configured semantic APIs. MCP startup instructions and knowledge://workspace expose this workflow. Project-scoped CLI installs bind their root automatically; global installs follow client roots unless explicitly configured.

See Workspace and code locations. Refresh stale positions before editing; use filesystem tools for unavailable or excluded code.

Code Graph

Build a multilingual AST symbol graph with index_code_graph(path, project_name) using SQLite alone. index_codebase also builds it; file indexing and watching update relationships automatically. Use find_references, callers, and graph_context to inspect source evidence and bounded relationship context. SQLite remains the graph backend. JS/TS retain compiler resolution; Python, PHP, Go, Java, C/C++, C#, Rust, Ruby, Kotlin, Swift, Scala and Lua use bundled offline Tree-sitter profiles. See the language coverage and resolution limits in the graph guide.

AST chunking preserves function/class boundaries where possible. After upgrading, run index_codebase once to rebuild chunks and vectors. See Code Graph guide for resolution limits, offline usage, token budgets and quality evaluation.

Optional rerank

Hybrid search combines keyword results and embedding vectors using RRF. Optional reranking supports Voyage (RERANK_PROVIDER=voyage, VOYAGE_API_KEY or RERANK_API_KEY) and custom HTTP (RERANK_PROVIDER=http, RERANK_URL). Without a reranker, or if it fails, the original retrieval ranking is preserved. Exact symbol/regex modes skip reranking.

EnvRole
SEARCH_RERANKfalse disables reranking.
SEARCH_RERANK_POOLCandidate pool before final trim (default 50; at least the requested limit).
RERANK_PROVIDERnone, http, voyage; defaults to http when RERANK_URL is set, otherwise none.
RERANK_MODELVoyage model, default rerank-3-lite.
RERANK_URLCustom endpoint; HTTP contract is {query, documents} -> {scores}.
RERANK_API_KEYOptional Bearer credential; Voyage can use VOYAGE_API_KEY.
RERANK_TIMEOUT_MSFull request/body timeout, default 15000.

See Configuration.

Timeouts

To prevent hanging when Ollama or Qdrant are unresponsive, vibe-hnindex applies timeouts on all external calls. You can tune these via environment variables:

EnvDefaultControls
OLLAMA_TIMEOUT_MS30000 (30s)Max wait for Ollama /api/embed and /api/tags calls
QDRANT_TIMEOUT_MS15000 (15s)Max wait for Qdrant API calls (search, upsert, etc.)
SEARCH_TIMEOUT_MS60000 (60s)Overall timeout for the entire search operation

Set any of these to a higher value if you have a slow machine or large dataset. Set to 0 to disable the timeout for that layer (not recommended).

Google Antigravity

Use the same mcpServers block as above, but save it in Antigravity’s MCP file:

Filemcp_config.json under `.gemini/antigravity/` in your user folder
WindowsC:\Users\ \.gemini\antigravity\mcp_config.json
macOS / Linux~/.gemini/antigravity/mcp_config.json
UI⋮ menu → MCP → Manage MCP Servers → View raw config

Step-by-step: Integrations → Google Antigravity.


Features (short)

Search6 modes: keyword (FTS5+BM25), semantic (Qdrant vectors), hybrid (RRF fusion), regex, symbol, auto
Code Agentcode_session — 1 call replaces 5-15 searches. code_apply — safe code changes with auto test/lint/typecheck
Chat Memory 🆕Auto-track tool calls, semantic search via Qdrant, persistent AI context across sessions
StreamingParallel keyword+semantic search with progress notifications
Fuzzy SearchLevenshtein distance auto-corrects typos ("fucntion" → "function")
Smart ContextTask-aware context: impact analysis, test file detection, similar code patterns
StorageSQLite for keyword, graph and metadata; Qdrant for vectors; optional cloud embedding/rerank providers
IndexingIncremental change detection, parallel workers, watch mode, text indexing across languages, .hnindexignore
ResilienceKeyword search works without Qdrant or Ollama; graceful degradation
BenchmarkBuilt-in benchmark_search tool — compare streaming vs non-streaming, all search modes
Multiple Embedding ProvidersOllama, OpenAI, Voyage, Gemini and OpenAI-compatible APIs; provider/model-aware vector collections
Multiple Embedding Modelsbge-m3 (default), nomic-embed-text, qwen3-embedding, mxbai-embed-large, and more

Architecture

flowchart TB

accTitle: hnindex system architecture accDescr: An MCP agent calls a local hnindex server with workspace files and SQLite storage. Semantic retrieval optionally uses embeddings and Qdrant. agent_client["AI agent / MCP client Codex · Claude · Cursor"] subgraph local_workspace["Local workspace"] hnindex_server["hnindex MCP server Context · multilingual AST · code lookup"] project_files["Source files README · Git"] sqlite_store[("SQLite FTS · graph · declared tasks")] security_review["Security review Live source · bounded leads · validation plan"] hnindex_server --> security_review project_files --> security_review project_files -->|Read and check freshness| hnindex_server hnindex_server <-->|Index and task storage| sqlite_store end subgraph semantic_services["Optional semantic retrieval"] embedding_provider["Embeddings Ollama local or cloud API"]

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