Rust MCP

🚀 Rust MCP Server

このサーバーは、LLMを活用したRust開発において、rust - analyzerとの統合を提供する包括的なモデルコンテキストプロトコル（MCP）サーバーです。これにより、ClaudeなどのAIツールがrust - analyzerのLanguage Server Protocol機能を通じて、Rustコードを慣用的に扱うことができ、文字列操作を避け、インテリジェントなコード分析とリファクタリングを実現します。

🚀 クイックスタート

1. ビルド: cargo build --release
2. MCPクライアントを設定して、target/release/rustmcp を使用するようにします。
3. 「DebugとCloneを導出したUser構造体を生成する」などの自然言語プロンプトを使って、AIアシスタント経由で利用します。

✨ 主な機能 - 完全なツールセット（19個のツール）

コード分析（4つのツール）

• find_definition - シンボルの定義に移動
• find_references - シンボルのすべての使用箇所を検索
• get_diagnostics - 修正方法付きのコンパイラエラーや警告を取得
• workspace_symbols - プロジェクト内のシンボルを検索

コード生成（4つのツール）

• generate_struct - 導出とコンストラクタ付きの構造体を作成
• generate_enum - バリアント付きの列挙型を作成
• generate_trait_impl - スタブ付きのトレイト実装を生成
• generate_tests - 単体または統合テストのテンプレートを作成

リファクタリング（5つのツール）

• rename_symbol - スコープを考慮したシンボルの名前変更
• extract_function - コードを関数に抽出
• inline_function - 関数呼び出しをインライン化
• organize_imports - 使用宣言を並べ替えて整理
• format_code - rustfmtのフォーマットを適用

品質保証（2つのツール）

• apply_clippy_suggestions - clippyの自動修正を適用
• validate_lifetimes - ライフタイムと借用チェッカーの問題をチェック

プロジェクト管理（2つのツール）

• analyze_manifest - Cargo.tomlを解析
• run_cargo_check - エラー解析付きでcargo checkを実行

高度な機能（4つのツール）

• get_type_hierarchy - シンボルの型関係を取得
• suggest_dependencies - コードパターンに基づいてクレートの依存関係を提案
• create_module - 可視性を制御した新しいRustモジュールを作成
• move_items - ファイル間でコード項目を移動

追加の高度なツール

• change_signature - 関数のシグネチャを安全に変更

📦 インストール

前提条件

• Rustツールチェーン（1.70以上）
• rust - analyzerがインストールされている（デフォルト: ~/.cargo/bin/rust - analyzer）
• MCP互換のクライアント（Claude、Rooなど）

手順

1. このリポジトリをクローンします:

git clone <repository-url>
cd rust-mcp

2. サーバーをビルドします:

cargo build --release

3. サーバーのバイナリは target/release/rustmcp に生成されます。

🛠️ 設定

環境変数

サーバーは以下の環境変数をサポートしています。

• RUST_ANALYZER_PATH - rust - analyzerバイナリへのパス（デフォルト: ~/.cargo/bin/rust - analyzer）

サーバーを実行するときに設定できます:

RUST_ANALYZER_PATH=/usr/local/bin/rust-analyzer ./target/release/rustmcp

または、MCPクライアントの設定ファイルに設定することもできます（以下の例を参照）。

Claude Desktop

以下の内容をClaude DesktopのMCP設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rust-analyzer": {
      "command": "/path/to/rust-mcp/target/release/rustmcp",
      "args": [],
      "env": {
        "RUST_ANALYZER_PATH": "/custom/path/to/rust-analyzer"
      }
    }
  }
}

rust - analyzerがデフォルトの場所（~/.cargo/bin/rust - analyzer）にある場合は、env セクションを省略できます。

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

Roo設定

Rooの設定ファイル（通常は ~/.roo/config.json）に以下を追加します。

{
  "mcp_servers": [
    {
      "name": "rust-analyzer",
      "command": "/path/to/rust-mcp/target/release/rustmcp",
      "args": [],
      "env": {
        "RUST_ANALYZER_PATH": "/custom/path/to/rust-analyzer"
      }
    }
  ]
}

rust - analyzerがデフォルトの場所にある場合は、空の env オブジェクトを使用できます。

{
  "mcp_servers": [
    {
      "name": "rust-analyzer",
      "command": "/path/to/rust-mcp/target/release/rustmcp",
      "args": [],
      "env": {}
    }
  ]
}

その他のMCPクライアント

MCP互換のクライアントでは、以下を実行するように設定します。

/path/to/rust-mcp/target/release/rustmcp

サーバーはstdioトランスポートを使用し、MCPプロトコルメッセージを受け付ける準備ができています。

💻 使用例

設定が完了したら、AIアシスタントを通じてツールを使用できます。以下はいくつかの例です。

コード分析

"このRustプロジェクト内の `Config` 構造体のすべての参照を検索する"
"`parse_args` 関数の定義を表示する"
"src/main.rs のコンパイラエラーをチェックする"
"ワークスペース内で 'user' と一致するすべてのシンボルを検索する"

コード生成

"フィールドが name (String)、age (u32)、email (String) で、DebugとCloneを導出した `User` という名前の構造体を生成する"
"`HttpStatus` という名前の列挙型を、バリアント Ok、NotFound、ServerError で作成する"
"`calculate_total` 関数の単体テストを生成する"
"User構造体のDisplayトレイト実装を生成する"

リファクタリング

"コードベース全体で `data` 変数を `user_input` に名前変更する"
"このコードブロックを `validate_input` という名前の別の関数に抽出する"
"42行目の `helper_function` 呼び出しをインライン化する"
"src/lib.rs のすべてのインポート文を整理する"
"src/lib.rs のすべてのコードをフォーマットする"

品質保証

"clippyを実行し、コード品質を向上させるためのすべての自動修正を適用する"
"src/auth.rs のライフタイムまたは借用チェッカーの問題をチェックする"

プロジェクト管理

"Cargo.toml ファイルを解析し、依存関係の情報を表示する"
"cargo check を実行し、コンパイルエラーを報告する"

高度な機能

"src/main.rs の15行目、8文字目のシンボルの型階層を表示する"
"このワークスペース内のHTTPクライアント機能に適したクレートの依存関係を提案する"
"src/auth.rs に 'auth' という名前の新しいパブリックモジュールを作成する"
"User構造体と validate_user 関数を src/main.rs から src/user.rs に移動する"
"process_data 関数のシグネチャを所有権ではなく参照を受け取るように変更する"

🔧 技術詳細

サーバーはモジュール化されたアーキテクチャで構築されています。

• src/main.rs - エントリポイントとサーバーの初期化
• src/lib.rs - モジュール宣言
• src/server/ - MCPサーバーの実装
  • handler.rs - rmcpクレートを使用したツールハンドラーとMCPサーバーのロジック
  • parameters.rs - すべてのツールのパラメータ型定義
• src/analyzer/ - rust - analyzer LSPクライアントの統合
  • client.rs - LSPクライアントの実装とプロトコル処理
• src/tools/ - モジュール化されたツールの実装
  • types.rs - ツールディスパッチャーと定義
  • analysis.rs - コード分析ツール（find_definition、find_referencesなど）
  • generation.rs - コード生成ツール（generate_struct、generate_enumなど）
  • refactoring.rs - リファクタリングツール（rename_symbol、extract_functionなど）
  • formatting.rs - コードフォーマットツール
  • quality.rs - 品質保証ツール（clippy、lifetimes）
  • cargo.rs - プロジェクト管理ツール
  • navigation.rs - ナビゲーションツール（workspace_symbols）
  • advanced.rs - 高度な機能（型階層、依存関係、モジュール）

開発

開発環境での実行

cargo run

個々のツールのテスト

サーバーはすべてのツールをMCPプロトコルを通じて公開しています。デバッグするには、以下の手順を実行できます。

1. サーバーを実行: cargo run
2. stdinを介してMCPメッセージを送信（JSON - RPC形式）
3. サーバーのログと応答を確認

新しいツールの追加

1. 適切な src/tools/*.rs ファイルにツールの実装関数を作成します。
2. src/server/parameters.rs にパラメータ構造体を追加します。
3. src/tools/types.rs の execute_tool マッチ文にツールを追加します。
4. src/tools/types.rs の get_tools() 関数にツール定義を追加します。
5. src/server/handler.rs の RustMcpServer に対応する #[tool] メソッドを追加します。
6. 必要に応じて、src/analyzer/client.rs にアナライザークライアントメソッドを追加します。

トラブルシューティング

rust - analyzerが見つからない場合

rust - analyzerがインストールされており、アクセス可能であることを確認してください。サーバーは以下の順序でrust - analyzerを探します。

1. RUST_ANALYZER_PATH 環境変数で指定されたパス
2. デフォルトの場所: ~/.cargo/bin/rust - analyzer

カスタムパスを使用するには、環境変数を設定します。

export RUST_ANALYZER_PATH=/custom/path/to/rust-analyzer

または、上記の設定セクションで説明したように、MCPクライアントの設定で構成します。

MCP接続の問題

• MCPクライアントの設定内のサーバーバイナリのパスを確認してください。
• バイナリに実行権限があることを確認してください: chmod +x target/release/rustmcp
• 同じMCPサーバー名を使用している他のプロセスがないことを確認してください。

LSP通信エラー

• rust - analyzerが独立して動作することを確認してください: rust - analyzer --version
• Rustプロジェクトに有効な Cargo.toml があることを確認してください。
• ツールを呼び出すときのワークスペースパスが正しいことを確認してください。

コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. テストを含めて変更を実装します。
4. プルリクエストを送信します。