Roberto MCP

🚀 Roberto MCP

Rustで構築された、高速で言語に依存しないコード分析MCP（Model Context Protocol）サーバー。大規模コードベースに対して、シンボルの瞬時検索、参照追跡、およびセマンティックなコード検索を提供し、パフォーマンスを最優先としています。

🚀 クイックスタート

Roberto MCPは、Rustで構築された高速なコード分析サーバーです。大規模なコードベースに対して、シンボルの瞬時検索や参照追跡、セマンティックなコード検索などの機能を提供します。

✨ 主な機能

• ⚡ 高いパフォーマンス：シンボル検索が1ms未満、インデックス作成速度が100ファイル/秒以上
• 🔒 ロックフリーな並行処理：ブロッキング操作がなく、並行リクエストを効率的に処理
• 🧠 スマートキャッシュ：バイナリ永続化を使用し、以前にインデックス化されたリポジトリの起動時間が1秒未満
• 📊 メモリ管理：設定可能なメモリ制限で自動的にLRUキャッシュを削除
• 🔄 インクリメンタル更新：SHA-256を使用したファイル変更検出によるファイル監視
• 🌍 多言語対応：15以上の言語をサポートし、拡張可能なアーキテクチャ
• 🛡️ エラー耐性：不正なコードやI/Oエラーを適切に処理
• 🔍 全文検索：BM25統計検索を使用したコード内容の検索

🏗️ アーキテクチャ

• 言語：Rust（パフォーマンスと安全性）
• パーサー：Tree-sitter（一貫性のあるインクリメンタルパース）
• ストレージ：メモリ内のDashMapとバイナリ永続化
• 並行処理：ロックフリーなデータ構造
• プロトコル：JSON-RPC stdioを介したMCP

📋 MCPツール

サーバーは、包括的なコード分析のための7つのMCPツールを提供します。

1. index_code

ソースコードファイルをインデックス化し、高速検索用のシンボルテーブルを構築します。

{
  "path": "/path/to/project"
}

2. get_symbol

名前でシンボル情報を取得し、ソースコードの包含をオプションで指定できます。

{
  "name": "function_name",
  "include_source": true
}

3. get_symbol_references

コードベース全体でシンボルのすべての参照を検索します。

{
  "name": "symbol_name"
}

4. find_symbols

クエリを使用してシンボルを検索し、完全一致またはファジー検索を行い、オプションでタイプをフィルタリングできます。

{
  "query": "test_",
  "symbol_type": "function"
}

5. code_search 🎯

BM25統計検索を使用した、すべてのインデックス化されたコード内容の検索。

{
  "query": "fibonacci algorithm",
  "max_results": 10
}

以下の検索に最適です：

• アルゴリズムの実装："binary search algorithm"
• エラーハンドリングパターン："error handling try catch"
• データベースコード："database connection pool"
• 特定の機能："file upload validation"

6. get_file_outline 📄

特定のファイル内のシンボルの構造化されたアウトラインを取得します。

{
  "file_path": "/path/to/file.rs"
}

以下の情報の整理されたビューを返します：

• シグネチャ付きのクラス/構造体
• 完全なシグネチャとパラメータ付きの関数/メソッド
• 定数、列挙型、インターフェース、モジュール、インポート、変数
• 行番号と可視性（pub/priv）

7. get_directory_outline 📁

ディレクトリ全体のシンボルの概要を取得します。

{
  "directory_path": "/path/to/project",
  "includes": ["functions", "methods", "constants"]
}

以下の用途に最適です：

• プロジェクト構造の理解
• APIサーフェスの発見
• アーキテクチャの概要
• コードナビゲーション

📦 インストール

前提条件

• Rust 1.70以上とCargo
• Git

ソースからビルド

git clone https://github.com/kensave/roberto-mcp.git
cd roberto-mcp
cargo build --release

バイナリはtarget/release/roberto-mcpに生成されます。

💻 使用例

Amazon Q CLIを使用する場合

1. Amazon Q CLIの設定に追加する

   以下をAmazon Q CLIのMCP設定に追加します。

   {
     "mcpServers": {
       "roberto": {
         "command": "/path/to/roberto-mcp/target/release/roberto-mcp",
         "args": []
       }
     }
   }
   

2. Amazon Q CLIを再起動する

3. 使用を開始する

   Amazon Q CLIで以下のような質問をすることができます。

   • "プロジェクトディレクトリ内のコードをインデックス化してください"
   • "名前に'parse'を含むすべての関数を検索してください"
   • "SymbolStore構造体のすべての参照を表示してください"
   • "extract_symbols関数の実装を表示してください"
   • "フィボナッチアルゴリズムの実装を検索してください"
   • "コードベース内のエラーハンドリングパターンを検索してください"
   • "このファイルのすべての関数とそのシグネチャを含むアウトラインを表示してください"
   • "このディレクトリ内のすべてのクラスとメソッドの概要を取得してください"

MCP Inspectorを使用してテストする場合

MCP Inspectorは、MCPサーバーのテストとデバッグに便利なツールです。

1. MCP Inspectorをインストールする

   npx @modelcontextprotocol/inspector
   

2. サーバーをテストする

   # サーバーを起動する
   ./target/release/roberto-mcp
   
   # 別のターミナルでMCP Inspectorを起動する
   npx @modelcontextprotocol/inspector ./target/release/roberto-mcp
   

3. ツールを探索する

   • 利用可能なツールとそのスキーマを表示する
   • サンプルデータでツール呼び出しをテストする
   • リクエスト/レスポンスサイクルを検査する
   • 統合問題をデバッグする

コマンドラインを使用して手動でテストする場合

stdioを使用してサーバーを手動でテストすることもできます。

# サーバーを起動する
./target/release/roberto-mcp

# MCP初期化を送信する（このJSONを貼り付ける）
{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test-client", "version": "1.0.0"}}}

# 初期化通知を送信する
{"jsonrpc": "2.0", "method": "notifications/initialized"}

# 利用可能なツールをリストする
{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}

# ディレクトリをインデックス化する
{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "index_code", "arguments": {"path": "/path/to/your/project"}}}

# シンボルを検索する
{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "find_symbols", "arguments": {"query": "main", "symbol_type": "function"}}}

# BM25を使用してコード内容を検索する
{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "code_search", "arguments": {"query": "error handling", "max_results": 5}}}

# シグネチャ付きのファイルアウトラインを取得する
{"jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": {"name": "get_file_outline", "arguments": {"file_path": "/path/to/file.rs"}}}

# ディレクトリの概要を取得する
{"jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": {"name": "get_directory_outline", "arguments": {"directory_path": "/path/to/project", "includes": ["functions", "classes"]}}}

🔧 技術詳細

パフォーマンスベンチマーク

システム上でのパフォーマンスを検証するには、含まれているベンチマークを実行します。

# すべてのベンチマークを実行する
cargo bench

# 特定のベンチマークを実行する
cargo bench -- symbol_lookup

# パフォーマンス検証テストを実行する
cargo test --test performance_validation -- --nocapture

期待されるパフォーマンス目標：

• シンボル検索：平均1ms未満
• インデックス作成速度：100ファイル/秒以上
• 並行アクセス：50k以上の検索/秒
• メモリ使用量：大規模なリポジトリで1GB未満

テスト

プロジェクトには包括的なテストが含まれています。

# すべてのテストを実行する
cargo test

# 単体テストのみを実行する
cargo test --lib

# 統合テストを実行する
cargo test --test integration_test

# パフォーマンス検証を実行する
cargo test --test performance_validation

# デバッグ用に出力を表示して実行する
cargo test -- --nocapture

テストカバレッジ：

• すべてのコアモジュールをカバーする54の単体テスト
• エンドツーエンドのワークフローのための5つの統合テスト
• 要件を検証する5つのパフォーマンステスト
• 15の言語固有のテスト
• 4つのアウトラインツールテスト

合計：83のテストが合格

サポートされている言語

現在、15以上の言語をサポートしています。

• Rust (.rs)：関数、構造体、列挙型、トレイト、実装、定数、モジュール
• Python (.py)：関数、クラス、メソッド、変数、インポート
• JavaScript (.js)：関数、クラス、メソッド、定数、変数
• TypeScript (.ts)：関数、クラス、インターフェース、型、列挙型
• Java (.java)：クラス、メソッド、インターフェース、列挙型、定数
• Go (.go)：関数、構造体、インターフェース、定数、変数
• C (.c)：関数、構造体、列挙型、typedef、変数
• C++ (.cpp, .hpp)：クラス、関数、名前空間、テンプレート
• Ruby (.rb)：クラス、モジュール、メソッド、定数
• PHP (.php)：クラス、関数、メソッド、定数
• C# (.cs)：クラス、メソッド、インターフェース、列挙型、プロパティ
• Kotlin (.kt)：クラス、関数、インターフェース、オブジェクト
• Scala (.scala)：クラス、オブジェクト、トレイト、関数
• Swift (.swift)：クラス、構造体、プロトコル、関数
• Objective-C (.m, .h)：クラス、メソッド、プロトコル、カテゴリ

新しい言語の追加： アーキテクチャは拡張が容易に設計されています。新しい言語を追加するには、以下の手順を実行します。

1. Tree-sitterの文法依存関係を追加する
2. queries/ディレクトリにクエリファイルを作成する
3. Language列挙型と言語検出を更新する
4. サポートされている拡張子に追加する

キャッシュと永続化

• キャッシュの場所：システムのキャッシュディレクトリを使用します（Unixでは~/.cache/roberto-mcp/）
• キャッシュ形式：bincodeシリアライゼーションを使用したカスタムバイナリ形式
• キャッシュキー：リポジトリのパスと最終更新時間に基づいています
• キャッシュの検証：起動時に自動的に検証され、インクリメンタル更新が行われます
• メモリ管理：メモリ圧力が検出された場合、LRUキャッシュが自動的に削除されます（設定可能）

エラーハンドリング

サーバーは堅牢性を念頭に設計されています。

• パースエラー：他のファイルのインデックス化を続行し、問題をログに記録します
• ファイルシステムエラー：部分的な結果で正常に動作を継続します
• メモリ圧力：自動的にクリーンアップとキャッシュの削除が行われます
• 不正なリクエスト：適切なMCPエラーレスポンスを返します
• 並行アクセス：ロックフリーなデータ構造により、デッドロックが防止されます

モニタリングとロギング

サーバーは、異なるレベルの構造化ロギングを使用しています。

# デバッグロギングを有効にする
RUST_LOG=debug ./target/release/roberto-mcp

# 特定のモジュールのトレースロギングを有効にする
RUST_LOG=roberto_mcp::indexer=trace ./target/release/roberto-mcp

設定

環境変数

# メモリ管理
export ROBERTO_MAX_MEMORY_MB=1024
export ROBERTO_EVICTION_THRESHOLD=0.8

# キャッシュの場所
export ROBERTO_CACHE_DIR=~/.cache/roberto-mcp

# ロギング
export RUST_LOG=roberto_mcp=info

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細については、LICENSEファイルを参照してください。

📚 ドキュメント

• アーキテクチャガイド - 詳細なシステムアーキテクチャ
• 開発ガイド - セットアップと開発ワークフロー
• APIリファレンス - 完全なMCPツールのドキュメント

❤️ 高速なコード分析のためにRustで構築されました