Rust MCP Server

🚀 Rust MCP Server

Rustで書かれたModel Context Protocol (MCP) サーバーで、Rustプロジェクトに対するAI支援型コード分析ツールを提供します。このサーバーにより、AIエージェントはRustコードベースに対して高度なコード分析、ナビゲーション、リファクタリング提案を行うことができます。

✨ 主な機能

• ファイル分析：Rustファイルを解析し、構文エラーをチェックします。
• ワークスペースインデックス作成：包括的な呼び出しグラフ、型使用グラフ、モジュール依存グラフを構築します。
• コードナビゲーション：シンボルの定義と参照を検索します。
• コードの臭い検出：未使用の関数、長い関数、高い複雑度のコード、万能オブジェクトを特定します。
• リファクタリング提案：コード改善の自動提案を行います。

🔧 技術詳細

サーバーは以下を使用しています。

• rmcpクレート：MCPプロトコルの処理
• syn：Rust ASTの解析
• tokio：非同期操作
• RwLockを使用したスレッドセーフなキャッシュ
• ASTトラバーサルのためのビジターパターン

📦 インストール

前提条件

• DockerとDocker Compose（Docker Hubを使用する場合）
• Git（開発用、オプション）
• Rust 1.70以上（ソースからビルドする場合のみ）

注意：ほとんどのユーザーにとって、Dockerが唯一の要件です。Dockerイメージは最新のMCP SDK機能をサポートするためにRust nightlyを使用しています。

Docker Hubからのインストール（推奨）

# 方法1: 直接実行（自動でダウンロード）
docker run --rm -i mytheclipse/rust-mcp-server:latest

# 方法2: まずプルしてから実行
docker pull mytheclipse/rust-mcp-server:latest
docker run --rm -i mytheclipse/rust-mcp-server:latest

# 方法3: Docker Composeを使用
docker run --rm -i -v $(pwd):/workspace mytheclipse/rust-mcp-server:latest

開発用インストール

# リポジトリをクローン
git clone https://github.com/MythEclipse/rust-mcp-server.git
cd rust-mcp-server

# Docker Composeで実行（開発用に推奨）
docker-compose up --build

# または手動でビルドして実行
docker build -t rust-mcp-server .
docker run --rm -i rust-mcp-server

手動ビルド（上級者向け）

ソースからビルドする場合は、以下の手順を実行します。

前提条件

• Rust 1.70以上（2024エディション）
• Cargo

ソースからビルド

git clone https://github.com/MythEclipse/rust-mcp-server.git
cd rust-mcp-server
cargo build --release
./target/release/rust-mcp-server

💻 使用例

MCPサーバーの実行

Docker Hub（推奨）

# Docker Hubから最新バージョンを実行
docker run --rm -i mytheclipse/rust-mcp-server:latest

# ワークスペースボリュームをマウントして実行（ファイル分析用）
docker run --rm -i -v $(pwd):/workspace mytheclipse/rust-mcp-server:latest

# バックグラウンドで実行
docker run -d --name rust-mcp-server mytheclipse/rust-mcp-server:latest

# バックグラウンドコンテナを停止
docker stop rust-mcp-server && docker rm rust-mcp-server

Docker Composeを使用した開発

# リポジトリをクローン（開発用）
git clone https://github.com/MythEclipse/rust-mcp-server.git
cd rust-mcp-server

# ホットリロードで実行
docker-compose up --build

# バックグラウンドで実行
docker-compose up -d

# ログを表示
docker-compose logs -f

# 停止
docker-compose down

手動実行（上級者向け）

ソースからビルドした場合は、以下のように実行できます。

# コンパイル済みのバイナリを実行
./target/release/rust-mcp-server

# またはCargoで実行
cargo run

MCPプロトコルの統合

このサーバーはModel Context Protocol (MCP) を実装し、stdioを介してJSON-RPC 2.0を使用して通信します。AIコーディングアシスタントなどのMCP互換クライアントと統合するように設計されています。

利用可能なツール

1. ファイルチェック

Rustファイルを解析し、構文エラーをチェックします。

パラメーター：

• path：チェックするRustファイルの絶対パス

MCP呼び出しの例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_file",
    "arguments": {
      "path": "/path/to/your/file.rs"
    }
  }
}

応答の例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "File parsed successfully with no syntax errors."
      }
    ]
  }
}

2. ワークスペースのインデックス作成

ディレクトリ内のすべてのRustファイルをインデックス化し、包括的な分析グラフを構築します。

パラメーター：

• root：インデックス化するルートディレクトリのパス

MCP呼び出しの例：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "index_workspace",
    "arguments": {
      "root": "/path/to/rust/project"
    }
  }
}

返り値：

• 呼び出しグラフ（関数関係）
• 型使用グラフ（型が使用されている場所）
• モジュール依存グラフ
• 関数情報（複雑度、行数、パラメーター）
• 構造体と列挙型の情報
• 未使用関数の検出
• リファクタリング提案

3. 定義へ移動

シンボルの定義場所を検索します。

パラメーター：

• name：定義を検索するシンボル名

MCP呼び出しの例：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "goto_definition",
    "arguments": {
      "name": "MyStruct"
    }
  }
}

4. 参照を検索

シンボルのすべての参照を検索します。

パラメーター：

• name：参照を検索するシンボル名

MCP呼び出しの例：

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "find_references",
    "arguments": {
      "name": "my_function"
    }
  }
}

実用的な使用例

Rustプロジェクトの分析

1. MCPサーバーを起動：

cargo run

2. ワークスペースをインデックス化（別のターミナルまたはMCPクライアントで）：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "index_workspace",
    "arguments": {
      "root": "/home/user/my-rust-project"
    }
  }
}

3. 特定のファイルの構文エラーをチェック：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "check_file",
    "arguments": {
      "path": "/home/user/my-rust-project/src/main.rs"
    }
  }
}

4. 関数の定義場所を検索：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "goto_definition",
    "arguments": {
      "name": "process_data"
    }
  }
}

AIアシスタントとの統合

このサーバーはMCPをサポートするAIコーディングアシスタントと連携するように設計されています。通常の統合方法は以下の通りです。

1. AIアシスタントがMCPサーバーをサブプロセスとして起動
2. stdioを介してJSON-RPC 2.0で通信
3. アシスタントがツールを呼び出してコードを分析、ナビゲート、提案を取得
4. 結果を使用してインテリジェントなコード支援を提供

コマンドラインでのテスト

socatなどのツールを使用して手動でサーバーをテストすることもできます。開発目的では、組み込みのテストを使用することもできます。

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

# 特定のツールのテストを実行
cargo test test_index_workspace
cargo test test_check_file

コード分析の出力

ワークスペースをインデックス化すると、サーバーは包括的な分析結果を返します。

関数分析：

• 50行以上の関数
• 複雑度が10を超える関数
• 5つ以上のパラメーターを持つ関数

構造分析：

• 10個以上のフィールドを持つ構造体
• 10個以上のバリアントを持つ列挙型

依存関係分析：

• 10個以上の他の関数を呼び出す関数
• 10個以上の他の関数から呼び出される関数
• 10箇所以上で使用される構造体（万能オブジェクト）

未使用コード：

• 呼び出されないプライベート関数

エラーハンドリング

サーバーは無効なリクエストに対して構造化されたエラーを返します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "details": "Path does not exist"
    }
  }
}

🛠️ 開発

ビルド

Dockerを使用する場合

# Dockerイメージをビルド
docker build -t rust-mcp-server .

# またはDocker Composeを使用
docker-compose build

手動ビルド

cargo build

テスト

Dockerを使用する場合

# Dockerコンテナ内でテストを実行（開発用）
docker run --rm -v $(pwd):/app mytheclipse/rust-mcp-server:latest cargo test

手動テスト

cargo test

開発ワークフロー

1. コードに変更を加える
2. ローカルでテストする：

cargo test

3. Dockerイメージをビルドする：

docker build -t rust-mcp-server .

4. Dockerイメージをテストする：

docker run rust-mcp-server

コード分析機能

サーバーはいくつかのタイプのコード分析を行います。

1. 関数分析

   • 行数の検出（50行を超えるとフラグ付け）
   • 循環的複雑度の計算（10を超えるとフラグ付け）
   • パラメーター数の分析（5つを超えるとフラグ付け）

2. 構造分析

   • 大規模な構造体の検出（10個以上のフィールド）
   • 大規模な列挙型の検出（10個以上のバリアント）

3. 依存関係分析

   • 10個以上の他の関数を呼び出す関数
   • 10個以上の他の関数から呼び出される関数
   • 万能オブジェクトの検出（10箇所以上で使用される構造体）

4. 未使用コードの検出

   • 呼び出されないプライベート関数

⚙️ 設定

MCPクライアントの設定

このMCPサーバーをMCP互換クライアントで使用するには、Dockerコンテナを実行するように設定します。

Claude Desktop用（claude_desktop_config.json）

{
  "mcpServers": {
    "rust-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "mytheclipse/rust-mcp-server:latest"]
    }
  }
}

VS Codeまたはその他のMCPクライアント用

{
  "mcpServers": {
    "rust-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "mytheclipse/rust-mcp-server:latest"]
    }
  }
}

Docker Composeを使用する場合

Docker Composeを使用する場合は、以下のように設定します。

{
  "mcpServers": {
    "rust-mcp-server": {
      "command": "docker-compose",
      "args": ["exec", "rust-mcp-server", "rust-mcp-server"],
      "cwd": "/path/to/rust-mcp-server"
    }
  }
}

設定パラメーター

• command：実行する実行可能ファイル (docker または docker-compose)
• args：コマンドに渡す引数の配列
• cwd：作業ディレクトリ - Docker Composeの設定でのみ必要で、docker-compose.yml を含むディレクトリを指す必要があります。

環境変数

サーバーの基本的な動作には環境変数は必要ありません。ただし、以下の環境変数を設定することができます。

• RUST_LOG：ログレベルを設定します（例: info, debug, trace）

Dockerイメージの管理

# イメージをローカルでビルド
docker build -t rust-mcp-server .

# Docker Hubからプル
docker pull mytheclipse/rust-mcp-server:latest

# カスタム環境変数を指定して実行
docker run -e RUST_LOG=debug mytheclipse/rust-mcp-server:latest

# ボリュームをマウントして実行（ホストファイルにアクセスする場合）
docker run -v /host/path:/container/path mytheclipse/rust-mcp-server:latest

Docker Hubへの公開

このイメージをDocker Hubにプッシュする詳細な手順については、DOCKER_HUB_DEPLOYMENT.md を参照してください。

公式のDocker Hubリポジトリは mytheclipse/rust-mcp-server です。

設定オプション

サーバーはデフォルトの設定を使用しており、追加の設定は必要ありません。すべての分析はツールが呼び出されたときにオンデマンドで実行されます。

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 新しい機能に対するテストを追加します。
5. cargo test が正常に終了することを確認します。
6. プルリクエストを送信します。

📄 ライセンス

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