ClaudeコードのMCPサーバーとセマンティックコード検索エンジン。

ハイブリッド検索: ベクトル + FTS + AST グラフ + ripgrep regex — RRF の融合と再評価.

2018年11月11日

クイックスタート

プロジェクトに追加 .mcp.json:

です。 index_project -> [Search] -> [locate]のツールを自動的に検出します。

LLM-enhanced検索(locate)を有効にするには、LM API キーを追加します。

インストール

プラットフォームに合ったインストールを選択します。

プラットフォームの推奨事項

| プラットフォーム | 推奨 | コマンド | お問い合わせ | [[T5] | [pip install codexlens-search[directml] | [pip install codexlens-search[directml] | [pip install codexlens-search[directml] | [pip install codexlens-search[directml] | [pip install codexlens-search[directml]] | [pip install codexlens-search[directml]] | [pip install codexlens-search[directml]] | [[pip install codexlens-search[directml]] | [[[pip install codexlens-search[directml]]] |[[pip install codexlens-search[directml]]]]] |[[[[[pip install codexlens-search[directml]]]]]] [[[[pip install codexlens-search[directml]]]]]]] | ※Windows CPUのみ ※ | ベース | [[T7] | | ※Linux + NVIDIA GPU** | [[T8] | [[T9] | | Linux CPU / AMD GPU** | ベース | [[T10] | | macOS(Apple Silicon)** | ベース | [[T11] | | [[T12] | [pip install codexlens-search[all] | [pip install codexlens-search[all] | [pip install codexlens-search[all] | [pip install codexlens-search[all] | [[all] | [[all] | [pip install codexlens-search[all]] | [pip install codexlens-search[all] | [[pip install codexlens-search[all]] | [[[all]]] |[[pip install codexlens-search[all]]] |[[[pip install codexlens-search[all]]] |[[[[pip install codexlens-search[all]]]]

**注記:Windowsでは、ベースパッケージを[[T14]なしでインストールすると、MCPサーバーは、最初の起動時に欠落したGPUランタイムを自動検出し、[[T15]をインストールします。 GPUは2回目のスタートから効果を発揮します.

codexlens-search

Semantic code search engine with MCP server for Claude Code.

Hybrid search: vector + FTS + AST graph + ripgrep regex — with RRF fusion and reranking.

中文文档

Quick Start

pip install codexlens-search[all]

Add to your project .mcp.json:

{
  "mcpServers": {
    "codexlens": {
      "command": "uvx",
      "args": ["--from", "codexlens-search[all]", "codexlens-mcp"],
      "env": {
        "CODEXLENS_EMBED_API_URL": "https://api.openai.com/v1",
        "CODEXLENS_EMBED_API_KEY": "${OPENAI_API_KEY}",
        "CODEXLENS_EMBED_API_MODEL": "text-embedding-3-small",
        "CODEXLENS_EMBED_DIM": "1536"
      }
    }
  }
}

That’s it. Claude Code will auto-discover the tools: index_project -> Search -> locate.

To enable LLM-enhanced search (locate), add LLM API keys:

{
  "mcpServers": {
    "codexlens": {
      "command": "uvx",
      "args": ["--from", "codexlens-search[all]", "codexlens-mcp"],
      "env": {
        "CODEXLENS_EMBED_API_URL": "https://api.openai.com/v1",
        "CODEXLENS_EMBED_API_KEY": "${OPENAI_API_KEY}",
        "CODEXLENS_EMBED_API_MODEL": "text-embedding-3-small",
        "CODEXLENS_EMBED_DIM": "1536",
        "CODEXLENS_LLM_EXPAND_API_KEY": "${GLM_API_KEY}",
        "CODEXLENS_LLM_EXPAND_MODEL": "glm-5-turbo",
        "CODEXLENS_LLM_EXPAND_API_BASE": "https://open.bigmodel.cn/api/paas/v4/"
      }
    }
  }
}

Install

Choose the install that matches your platform:

# Minimal — CPU inference (fastembed bundles onnxruntime CPU)
pip install codexlens-search

# Windows GPU — DirectML, any DirectX 12 GPU (NVIDIA/AMD/Intel)
pip install codexlens-search[directml]

# Linux/Windows NVIDIA GPU — CUDA (requires CUDA + cuDNN)
pip install codexlens-search[cuda]

# Auto-select — DirectML on Windows, CPU elsewhere
pip install codexlens-search[all]

Platform Recommendations

Note: On Windows, if you install the base package without [directml], the MCP server will auto-detect the missing GPU runtime and install onnxruntime-directml on first launch. GPU takes effect from the second start.

What’s Included

All install variants include:

• MCP server — codexlens-mcp command
• AST parsing — tree-sitter symbol extraction + graph search
• USearch — high-performance HNSW ANN backend (default)
• FAISS — ANN + binary index backend (Hamming coarse search)
• File watcher — watchdog auto-indexing