Repolode
投稿する
ory

ory/lumen

OllamaまたはLM Studioの埋め込みを使い、Claude Code、Codex、Cursor、OpenCodeにコードベースの意味検索を提供するローカルMCPサーバー。

GitHub で見る公式サイト
スター
317
フォーク
37
未解決の Issue
29
最終コミット
27 日前

これは何？

Lumenは、AIコーディングエージェント向けのローカルな意味検索エンジンです。MCPサーバーとして動作し、プロジェクトのベクトルインデックスを作成するため、エージェントはファイル全体を読む代わりに、semantic_searchを呼び出して関連する関数、型、モジュールを探せます。埋め込みはローカルのOllamaまたはLM Studioサーバーで生成され、sqlite-vecを使ってSQLiteに保存されます。そのため、コードがマシンの外に送信されることはなく、クラウドサービスや外部データベースも必要ありません。

ファイルは、GoではGo標準のASTを使い、その他の言語ではtree-sitterの文法を使って、意味のまとまりごとに分割されます。ファイルのハッシュを使ったMerkle treeにより、以降の実行では変更されたファイルだけが再度埋め込まれます。同じリポジトリのGit worktree間でインデックスデータを共有できます。インデックスはリポジトリ内ではなく、~/.local/share/lumenに保存されます。

Claude Code、Cursor、Codex、OpenCode向けのプラグインが用意されています。また、READMEには複数の言語でのバグ修正タスクに関するベンチマーク結果が掲載されており、パッチの品質を維持しながらコストとトークン使用量を削減できることが示されています。

主な機能

  • 01MCPツールを通じて関数、型、モジュールを意味検索
  • 02Merkle treeによる差分検出で、変更されたファイルだけを再度埋め込む増分インデックス作成
  • 03OllamaまたはLM Studioを使ったローカル埋め込みに対応し、クラウドに依存しない
  • 04sqlite-vecを使ってSQLiteにデータを保存し、プロジェクトディレクトリの外に保管
  • 05Go ASTとtree-sitterパーサーを使い、12の言語ファミリーに対応
  • 06Git worktree間でインデックスデータを共有し、新しいworktreeには兄弟worktreeのデータを引き継ぐ

ユースケース

  • Claude CodeやCodexがファイル全体を読むことなく、大規模なモノレポから関連コードを見つける
  • 埋め込み処理をすべてローカルマシンで実行し、ソースコードのプライバシーを保つ
  • AIエージェントが不慣れなコードベースを調べる際のトークン使用量を削減する
  • 同じプロジェクトの複数のGit worktreeでの作業を高速化する

クイックスタート

  1. 1

    Ollamaをインストールし、デフォルトの埋め込みモデルを取得する

    ollama pull ordis/jina-embeddings-v2-base-code
  2. 2

    マーケットプレイスからClaude Codeプラグインをインストールする

    /plugin marketplace add ory/claude-plugins
  3. 3

    Claude CodeにLumenプラグインをインストールする

    /plugin install lumen@ory
  4. 4

    新しいClaudeセッションを開始し、ヘルスチェックを実行する

    /lumen:doctor

使う前に知っておきたいこと

  • エージェントと並行して、ローカルのOllamaまたはLM Studioの埋め込みサーバーを起動しておく必要があります。
  • メタデータ上のライセンスはNOASSERTIONとなっているため、使用前にLICENSEファイルを確認してください。

収録されている特集

Claude Code 向け MCP サーバーローカル LLM でコーディングClaude Code のツール・スキル・プラグインMCP サーバーLLM をローカルで動かす

トピック

#code-search#semantic-search#mcp#claude-code#embeddings#local-llm#sqlite-vec#agentic-coding#claude#claude-ai

よくある質問

lumen とは？
OllamaまたはLM Studioの埋め込みを使い、Claude Code、Codex、Cursor、OpenCodeにコードベースの意味検索を提供するローカルMCPサーバー。 Lumenは、AIコーディングエージェント向けのローカルな意味検索エンジンです。MCPサーバーとして動作し、プロジェクトのベクトルインデックスを作成するため、エージェントはファイル全体を読む代わりに、semantic_searchを呼び出して関連する関数、型、モジュールを探せます。埋め込みはローカルのOllamaまたはLM Studioサーバーで生成され、sqlite-vecを使ってSQLiteに保存されます。そのため、コードがマシンの外に送信されることはなく、クラウドサービスや外部データベースも必要ありません。
lumen は無料で使えますか？ライセンスは？
lumen は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
lumen は今もメンテナンスされていますか？
活発にメンテナンス中。lumen の最終コミットは 2026年10月11日 です。
lumen は何に使えますか？
Claude CodeやCodexがファイル全体を読むことなく、大規模なモノレポから関連コードを見つける 埋め込み処理をすべてローカルマシンで実行し、ソースコードのプライバシーを保つ AIエージェントが不慣れなコードベースを調べる際のトークン使用量を削減する 同じプロジェクトの複数のGit worktreeでの作業を高速化する
lumen のインストール方法は？
Ollamaをインストールし、デフォルトの埋め込みモデルを取得する: ollama pull ordis/jina-embeddings-v2-base-code マーケットプレイスからClaude Codeプラグインをインストールする: /plugin marketplace add ory/claude-plugins Claude CodeにLumenプラグインをインストールする: /plugin install lumen@ory 新しいClaudeセッションを開始し、ヘルスチェックを実行する: /lumen:doctor
lumen はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/ory/lumen

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト