Vexor

---

Vexor は、ファイルやコードを対象とした再利用可能なインデックスを構築するセマンティック検索エンジンです。 設定可能な埋め込みおよび再ランキングプロバイダーに対応し、Python API、CLI ツール、MCP サーバーから同じコア機能を利用できます。

Vexor のデモ動画

掲載実績

Vexor はコミュニティから評価され、さまざまな場所で紹介されています。

• Ruan Yifeng's Weekly (Issue #379) - 中国の開発者コミュニティを代表するテクノロジーニュースレターです。
• Awesome Claude Skills - AI エージェント向けの優れたスキルを厳選したリストです。
• Awesome MCP Servers - Model Context Protocol サーバーを厳選したリストです。
• Awesome CLI Apps - コマンドラインアプリを厳選したリストです。

Vexor を選ぶ理由

ファイルの 役割 は覚えているのに、名前や場所を忘れてしまったとき、Vexor がすぐに見つけます。grep パターンもディレクトリの走査も必要ありません。

人間と AI コーディングアシスタントの両方を対象に設計されており、自律型エージェントのワークフローでセマンティックなファイル検索を可能にします。

インストール

リリースからスタンドアロンバイナリをダウンロードするか（Python は不要です）、次のコマンドを実行します。

pip install vexor  # also works with pipx, uv

クイックスタート

0. ガイド付きセットアップ（推奨）

vexor init

設定ファイルが存在しない場合、最初の対話型操作コマンドを実行する前にもウィザードが自動で起動します。設定管理（vexor config）、MCP、ヘルプ、バージョンの各コマンドはそのまま実行されます。

1. 検索

vexor "api client config"  # defaults to search current directory
# or explicit path:
vexor search "api client config" --path ~/projects/demo --top 5
# in-memory search only:
vexor search "api client config" --no-cache 

Vexor は初回の検索時に自動でインデックスを作成します。出力例：

Vexor semantic file search results
──────────────────────────────────
#   Similarity   File path                       Lines   Preview
1   0.923        ./src/config_loader.py          -       config loader entrypoint
2   0.871        ./src/utils/config_parse.py     -       parse config helpers
3   0.809        ./tests/test_config_loader.py   -       tests for config loader

2. 明示的なインデックス作成（任意）

vexor index  # indexes current directory
# or explicit path:
vexor index --path ~/projects/demo --mode code

CI のウォームアップや、auto_index が無効になっている場合に便利です。

Python API

Vexor は Python から直接インポートして使用することもできます。

from vexor import index, search

index(path=".", mode="head")
response = search("config loader", path=".", mode="name")

for hit in response.results:
    print(hit.path, hit.score)

設定は CLI と同じ方法で、グローバルおよびプロジェクトレベルの設定を解決します。 実行時のオーバーライド、キャッシュ制御、呼び出しごとのオプションについては、 docs/api/python.md を参照してください。

AI エージェントスキル

このリポジトリには、AI エージェントが Vexor を効果的に利用するためのスキルが含まれています。

vexor install --skills claude  # Claude Code
vexor install --skills codex   # Codex

スキルのソース：plugins/vexor/skills/vexor-cli

MCP サーバー

メモ

Agent Skill と MCP サーバーは同じ主要機能を提供します。エージェントごとにどちらか一方を選んでください。 このスキルは、シェルを利用できるエージェント（Claude Code、Codex）にフル CLI の操作方法を教えるもので、vexor が PATH にインストールされていることを前提とします。MCP サーバーは検索をネイティブツールとして公開するため、あらゆる MCP クライアント（Cursor、Windsurf、Zed など）で動作し、uvx と環境変数を使えば事前のセットアップなしで初期化できます。

Vexor には組み込みの MCP stdio サーバーが含まれているため、MCP 対応エージェントはセマンティックファイル検索をネイティブツールとして利用できます。

claude mcp add vexor -- vexor mcp   # Claude Code
codex mcp add vexor -- vexor mcp    # Codex

または、任意の MCP クライアントで手動設定できます。必要に応じて、env 経由で API キーや設定のオーバーライドを指定できます（vexor init は不要です）。

{
  "mcpServers": {
    "vexor": {
      "command": "vexor",
      "args": ["mcp"],
      "env": {
        "VEXOR_API_KEY": "sk-...",
        "VEXOR_CONFIG_JSON": "{\"provider\": \"gemini\", \"rerank\": \"bm25\"}"
      }
    }
  }
}

サーバーは 2 つのツールを公開します。vexor_search（セマンティックファイル検索。該当するソーステキストを返すため、エージェントが追加でファイルを読み込む必要はほとんどありません）と、vexor_index（明示的なインデックスのウォームアップ）です。追加の依存関係は不要です。Vexor は公式 MCP レジストリに io.github.scarletkc/vexor として登録されています。ツールのスキーマ、環境変数、クライアントの設定方法については、docs/mcp.mdを参照してください。

設定

vexor init                             # guided setup (recommended)
vexor config --set-api-key "YOUR_KEY"  # or env: VEXOR_API_KEY / OPENAI_API_KEY / ...
vexor config --set-provider openai     # default; also gemini/voyageai/custom/local
vexor config --rerank hybrid           # optional: fuse exact keyword + semantic ranking
vexor config --show                    # view effective settings and origins

グローバル設定は ~/.vexor/config.json に保存されます。最も近い <project>/.vexor/config.json では、そのプロジェクトに限り、制限された動作フィールドをオーバーライドできます。シークレットではないフィールドは VEXOR_CONFIG_JSON 経由でも渡せます（MCP クライアントや CI に便利です）。ローカルの埋め込みモデルを使った完全オフラインでの利用にも対応しています。

完全なリファレンスについては、docs/configuration.mdを参照してください。プロジェクト設定のフィールドと優先順位、すべての設定コマンド、API キーと環境変数、再ランク付け方式（ハイブリッド／BM25／FlashRank／リモート）、リモートとローカルのプロバイダー、埋め込み次元、オフラインでのローカルモデルの設定について説明しています。

CLI リファレンス

日常的な使い方は vexor "query"、vexor search、vexor index で完結します（クイックスタートを参照）。コマンドの一覧、一般的なフラグ、インデックスモード（--mode auto/name/head/brief/full/code/outline）、.vexorignore ファイル、プロジェクトローカルのインデックス（vexor index --local）、キャッシュの動作、ポーセリン出力形式については、docs/cli.mdに記載されています。

ドキュメント

• 設定 — プロバイダー、API キー、再ランク付け、埋め込み次元、ローカルモデル
• CLI リファレンス — コマンド、フラグ、インデックスモード、キャッシュの動作
• MCP サーバー — クライアントの設定方法、環境変数、ツールのスキーマ
• Python API — プログラムからの利用方法
• Collections API — データベースを利用したテキストレコードとフィルタリング検索

コントリビューション

コントリビューション、イシュー、PR を歓迎します！コミットメッセージと PR タイトルはConventional Commitsに従ってください（例：feat(mcp): add stdio server）。役に立った場合はスターを付けてください。

スター履歴

ライセンス

MIT