Java Class Analyzer MCP Server

🚀 Java Class Analyzer MCP Server

Java Class Analyzer MCP Serverは、Model Context Protocol (MCP)に基づくJavaクラス分析サービスです。このサービスは、Mavenプロジェクトの依存関係をスキャンし、Javaクラスファイルを逆コンパイルし、classメソッドリストなどの詳細情報を取得し、LLMに提供してコード分析を行います。

🚀 クイックスタート

CursorなどのAIツールは、二方（内部呼び出し）や三方パッケージ（外部呼び出し）のインターフェースを直接生成することができますが、AIは現在のプロジェクトで開かれていない依存ソースコードを読み取ることができないため、生成されるコードには頻繁にエラーが発生し、場合によっては幻覚的なコーディングが行われます。

この問題を解決するために、一般的にはソースコードの内容を直接LLMに供給するか、ソースファイルを現在のプロジェクトに配置してから会話で参照することが行われます。

一方、ローカル逆コンパイルMCP方式を使用すると、jarパッケージ内のクラスとメソッドを正確に解析でき、コード生成の正確性と可用性を大幅に向上させることができます。

✨ 主な機能

• 🚀使いやすい: mcpサービスはTypeScriptで実装され、npmでパッケージ化されているため、配布とインストールが容易で、環境依存性が低いです。
• 🔍 依存関係のスキャン: Mavenプロジェクトのすべての依存JARパッケージを自動的にスキャンします。
• 📦 クラスインデックス: クラスの完全名からJARパッケージのパスへのマッピングインデックスを作成します。
• 🔄 逆コンパイル: CFRツール（内蔵済み）を使用して、.classファイルをリアルタイムでJavaソースコードに逆コンパイルします。
• 📊 クラス分析: Javaクラスの構造、メソッド、フィールド、継承関係などを分析します。
• 💾 スマートキャッシュ: 逆コンパイル結果をパッケージ名の構造に従ってキャッシュし、キャッシュ制御をサポートします。
• 🚀 自動インデックス作成: 分析を実行する前に自動的にインデックスをチェックして作成します。
• ⚙️ 柔軟な設定: 外部からCFRツールのパスを指定できます。
• 🤖 LLM統合: MCPプロトコルを通じてLLMにJavaコード分析機能を提供します。

💻 使用例

IDEでmcpサービスを登録する

エージェントの会話でmcpを使用する

📚 ドキュメント

mcpサービスのインストール

グローバルインストール（推奨）

npm install -g java-class-analyzer-mcp-server

インストール後は、java-class-analyzer-mcp コマンドを直接使用できます。

ローカルインストール

npm install java-class-analyzer-mcp-server

ソースコードからインストール

git clone https://github.com/handsomestWei/java-class-analyzer-mcp-server.git
cd java-class-analyzer-mcp-server
npm install
npm run build

MCPサービスの設定

方法1：生成された設定を使用する（推奨）

以下のコマンドを実行して設定テンプレートを生成します。

java-class-analyzer-mcp config -o mcp-client-config.json

その後、生成された設定内容をMCPクライアントの設定ファイルに追加します。

方法2：手動で設定する

以下の設定例を参考に、MCPクライアントの設定ファイルに追加します。

グローバルインストール後の設定：

{
    "mcpServers": {
        "java-class-analyzer": {
            "command": "java-class-analyzer-mcp",
            "args": ["start"],
            "env": {
                "NODE_ENV": "production",
                "MAVEN_REPO": "D:/maven/repository",
                "JAVA_HOME": "C:/Program Files/Java/jdk-11"
            }
        }
    }
}

ローカルインストール後の設定：

{
    "mcpServers": {
        "java-class-analyzer": {
            "command": "node",
            "args": [
                "node_modules/java-class-analyzer-mcp-server/dist/index.js"
            ],
            "env": {
                "NODE_ENV": "production",
                "MAVEN_REPO": "D:/maven/repository",
                "JAVA_HOME": "C:/Program Files/Java/jdk-11"
            }
        }
    }
}

パラメータの説明

• command: MCPサーバーを実行するコマンドで、ここでは node を使用します。
• args: Node.jsに渡すパラメータで、npm run build でコンパイルされたdistフォルダ内のファイルを指します。
• env: 環境変数の設定です。

環境変数の説明

• NODE_ENV: 実行環境の識別子です。
  • production: 本番環境で、ログ出力を減らし、パフォーマンス最適化を有効にします。
  • development: 開発環境で、詳細なデバッグ情報を出力します。
  • test: テスト環境です。
• MAVEN_REPO: Mavenのローカルリポジトリのパス（オプション）です。
  • 設定すると、プログラムは指定されたリポジトリパスを使用してJARパッケージをスキャンします。
  • 設定しない場合、プログラムはデフォルトの ~/.m2/repository パスを使用します。
• JAVA_HOME: Javaのインストールパス（オプション）です。
  • 設定すると、プログラムは ${JAVA_HOME}/bin/java を使用してJavaコマンドを実行します（CFR逆コンパイルに使用）。
  • 設定しない場合、プログラムはPATH内の java コマンドを使用します。
• CFR_PATH: CFR逆コンパイルツールのパス（オプションで、プログラムが自動的に検索します）。

利用可能なツール

1. scan_dependencies

Mavenプロジェクトのすべての依存関係をスキャンし、クラス名からJARパッケージへのマッピングインデックスを作成します。

パラメータ:

• projectPath (string): Mavenプロジェクトのルートディレクトリのパス
• forceRefresh (boolean, オプション): インデックスを強制的に更新するかどうか。デフォルトはfalseです。

例:

{
  "name": "scan_dependencies",
  "arguments": {
    "projectPath": "/path/to/your/maven/project",
    "forceRefresh": false
  }
}

2. decompile_class

指定されたJavaクラスファイルを逆コンパイルし、Javaソースコードを返します。

パラメータ:

• className (string): 逆コンパイルするJavaクラスの完全名。例: com.example.QueryBizOrderDO
• projectPath (string): Mavenプロジェクトのルートディレクトリのパス
• useCache (boolean, オプション): キャッシュを使用するかどうか。デフォルトはtrueです。毎回の繰り返し生成を避けます。
• cfrPath (string, オプション): CFR逆コンパイルツールのjarパッケージのパス。内蔵済みですが、別のバージョンを指定することもできます。

例:

{
  "name": "decompile_class",
  "arguments": {
    "className": "com.example.QueryBizOrderDO",
    "projectPath": "/path/to/your/maven/project",
    "useCache": true,
    "cfrPath": "/path/to/cfr-0.152.jar"
  }
}

3. analyze_class

Javaクラスの構造、メソッド、フィールドなどの情報を分析します。

パラメータ:

• className (string): 分析するJavaクラスの完全名
• projectPath (string): Mavenプロジェクトのルートディレクトリのパス

例:

{
  "name": "analyze_class",
  "arguments": {
    "className": "com.example.QueryBizOrderDO",
    "projectPath": "/path/to/your/maven/project"
  }
}

キャッシュファイル

現在のプロジェクトでは、以下のキャッシュディレクトリとファイルが生成されます。

• .mcp-class-index.json: クラスインデックスのキャッシュファイル
• .mcp-decompile-cache/: 逆コンパイル結果のキャッシュディレクトリ（パッケージ名の構造に従って）
• .mcp-class-temp/: 一時ファイルのディレクトリ（パッケージ名の構造に従って）

🔧 技術詳細

ワークフロー

1. 自動インデックス作成: 初めてanalyze_classまたはdecompile_classを呼び出すときに、自動的にインデックスをチェックして作成します。
2. スマートキャッシュ: 逆コンパイル結果をパッケージ名の構造に従ってキャッシュし、キャッシュ制御をサポートします。
3. クラス分析: analyze_classまたはdecompile_classを使用してクラスの詳細情報を取得します。
4. LLM分析: 逆コンパイルされたソースコードをLLMに提供してコード分析を行います。

技術アーキテクチャ

核心コンポーネント

• DependencyScanner: Mavenの依存関係をスキャンし、クラスインデックスを作成する責任があります。
• DecompilerService: .classファイルを逆コンパイルする責任があります。
• JavaClassAnalyzer: Javaクラスの構造を分析する責任があります。
• MCP Server: 標準化されたMCPインターフェースを提供します。

依存関係のスキャンフロー

1. mvn dependency:treeを実行して依存関係ツリーを取得します。
2. 各JARパッケージを解析し、すべての.classファイルを抽出します。
3. "クラスの完全名 -> JARパッケージのパス"のマッピングインデックスを作成します。
4. インデックスを.mcp-class-index.jsonファイルにキャッシュします。

逆コンパイルフロー

1. クラス名に基づいて対応するJARパッケージのパスを検索します。
2. キャッシュをチェックし、存在してキャッシュが有効な場合は直接返します。
3. JARパッケージから.classファイルを.mcp-class-tempディレクトリに抽出します（パッケージ名の構造に従って）。
4. CFRツールを使用して.classファイルを逆コンパイルします。
5. 逆コンパイル結果をキャッシュ.mcp-decompile-cacheディレクトリに保存します（パッケージ名の構造に従って）。
6. Javaソースコードを返します。

トラブルシューティング

一般的な問題

1. Mavenコマンドが失敗する
   • Mavenがインストールされ、PATH内にあることを確認してください。
   • プロジェクトに有効なpom.xmlファイルがあることを確認してください。
2. CFR逆コンパイルが失敗する
   • CFR jarパッケージがダウンロードされていることを確認してください（任意のバージョン番号をサポートします）。
   • Java環境が正しく構成されていることを確認してください。
   • cfrPathパラメータを使用してCFRのパスを指定することができます。
3. クラスが見つからない
   • プログラムは自動的にインデックスをチェックして作成します。
   • クラス名が正しいことを確認してください。
   • プロジェクトの依存関係が正しく解析されていることを確認してください。

テストに関する説明

プロジェクトのビルド

npm install
npm run build

テストツールの使用

プロジェクトには独立したテストツールが用意されており、MCPクライアントを介さずにMCPサービスの各機能を直接テストすることができます。

# すべてのツールをテストする
node test-tools.js

# 特定のツールをテストする
node test-tools.js --tool decompile_class --class com.alibaba.excel.EasyExcelFactory --project /path/to/project

# キャッシュを使用しない
node test-tools.js --tool decompile_class --no-cache

# CFRのパスを指定する
node test-tools.js --tool decompile_class --cfr-path /path/to/cfr.jar

テストツールのパラメータ

• -t, --tool <ツール名>: テストするツールを指定します (scan|decompile|analyze|all)
• -p, --project <パス>: プロジェクトのパス
• -c, --class <クラス名>: 分析するクラス名
• --no-refresh: 依存関係のインデックスを強制的に更新しません
• --no-cache: 逆コンパイルのキャッシュを使用しません
• --cfr-path <パス>: CFR逆コンパイルツールのjarパッケージのパスを指定します
• -h, --help: ヘルプ情報を表示します

ログレベルの制御

NODE_ENV環境変数を使用してログ出力を制御します。

• development: 詳細なデバッグ情報を出力します。
• production: 重要な情報のみを出力します。