Shebe

🚀 Shebe

コード検索用のシンプルなRAGサービス

Claude CodeとのMCP統合を備えた、コードリポジトリ用の高速BM25全文検索です。

🚀 クイックスタート

INSTALLATION.mdを参照してください。

✨ 主な機能

Shebeとは何ですか？

Shebeはコードの内容検索を提供します。キーワード検索を使用して、大規模なコードベース全体で関数、API、パターンを見つけることができます。

主な特徴:

• 2msのクエリレイテンシー
• 2k - 12kファイル/秒のインデックス作成 (0.5秒で6kファイル)
• 200 - 700トークン/クエリ
• BM25のみ - 埋め込みやGPUは不要
• 完全なUTF-8サポート (絵文字、CJK、特殊文字)
• Claude Code用の14のMCPツール (リファレンス)

位置付け: 構造ツール (Serena MCP) を内容検索で補完します。

なぜShebeを使うのですか？

大規模なコードベース (6k以上のファイル) 全体でシンボルをリファクタリングする際に、開発者は精度 (LSPベースのツール) か効率 (grep/ripgrep) かの二択に直面します。Shebeはこのトレードオフを解消しようとしています。

ベンチマーク: Istio (~6kファイル) 全体での AuthorizationPolicy のリファクタリング

Shebeは、信頼度スコア付きでパターン分類された結果を1回の呼び出しで返すことで、エンドツーエンドの時間を6 - 10倍高速化し、トークン数を3 - 4倍削減します。

詳細なベンチマークとツールの比較については、WHY_SHEBE.md を参照してください。

簡単な比較

📦 インストール

INSTALLATION.mdを参照してください。

💻 使用例

一般的なタスク

特定の目標を達成するためのクイックリンクです。

ツール選択ガイド

内容検索 (Shebeを使用)

キーワード、パターン、テキスト内容でコードを見つけるのに最適です。

• "authenticate のすべての使用箇所を見つける"
• "レート制限が実装されている場所を教えて"
• "エラーハンドリングのパターンを表示する"
• "データベース接続の設定を見つける"

構造ナビゲーション (Serena/LSPを使用)

正確なシンボル操作と型情報に最適です。

• "UserService の定義に移動する"
• "Handler トレイトのすべての実装を見つける"
• "コードベース全体で oldFunc を newFunc にリネームする"
• "このクラスの型階層を表示する"

単純なパターンマッチング (grep/ripgrepを使用)

小規模なコードベースでの正確な文字列マッチに最適です。

• "正確な文字列 TODO: を見つける"
• "deprecated の出現回数をカウントする"
• "1,000ファイル未満のコードベースでの一度きりのクイック検索"

外部情報 (Web検索を使用)

ドキュメントやコミュニティの知識に最適です。

• "最新のReact 19移行ガイド"
• "特定のエラーのコミュニティソリューション"
• "アーキテクチャパターンに関するブログ記事"

Shebe + Serena を併用する

トークンを無駄にせずに完全なコードベースを探索するには、以下のようにします。

1. Shebe: "authenticateの使用箇所を見つける" -> ファイルを発見 (2ms, 300トークン)
2. Serena: "定義に移動する" -> 実装にナビゲート (正確)
3. Shebe: "似たパターンを見つける" -> 関連するコードを発見 (2ms, 300トークン)

📚 ドキュメント

はじめに

• INSTALLATION.md - インストールとセットアップガイド
• Quick Start Guide - Claude Codeの5分でのセットアップ

リファレンス

• MCP Tools Reference - 14のツールの完全なAPI
• CONFIGURATION.md - すべての設定オプション
• Performance Benchmarks - 詳細なパフォーマンスデータ

開発

• ARCHITECTURE.md - 開発者ガイド (コードを変更する場所と方法)
• CONTRIBUTING.md - コントリビュートの方法
• CODE_OF_CONDUCT.md - コミュニティガイドライン
• SECURITY.md - セキュリティポリシーと報告方法

🔧 技術詳細

パフォーマンス

Istio (5,605ファイル、Go主体) とOpenEMR (6,364ファイル、PHP多言語) で検証済み:

詳細なベンチマークについては、docs/Performance.md を参照してください。

アーキテクチャ

MCP専用設計

Shebeは、Claude Codeとの統合を目的としたMCPプロトコルを介してのみアクセスできます。HTTPサーバーは必要ありません。

システム設計

                    +------------------+
                    |   Claude Code    |
                    +--------+---------+
                             | MCP (stdio)
                    +--------v---------+
                    |   shebe-mcp      |
                    |   (14 tools)     |
                    +--------+---------+
                             |
                    +--------v---------+
                    |  Shared Storage  |
                    | ~/.local/state/  |
                    |  shebe/sessions/ |
                    +------------------+

開発者ガイドについては、ARCHITECTURE.md を参照してください。

トラブルシューティング

詳細なトラブルシューティングについては、docs/guides/mcp-setup-guide.md を参照してください。

📄 ライセンス

LICENSE を参照してください。

コントリビュート

コントリビューションを歓迎します！詳細なガイドラインについては、CONTRIBUTING.md を参照してください。

クイックチェックリスト:

1. コードベースガイドとして ARCHITECTURE.md を読む
2. すべての397のテストが合格すること (make test)
3. clippyの警告がないこと (make clippy)
4. 1行の最大文字数が120であること
5. テストカバレッジが85%以上を維持すること (現在86.76%)
6. 機能ブランチごとに1つのコミットにすること

コミュニティガイドラインについては、CODE_OF_CONDUCT.md を参照してください。