Lsp4j MCP

🚀 LSP4J - MCP サーバー

このJava MCP (Model Context Protocol) サーバーは、LSP4Jを使用してJDTLS (Eclipse JDT Language Server) をラップし、ClaudeなどのAIアシスタントにJava IDEの機能を提供します。

✨ 主な機能

このMCPサーバーは以下のツールを公開しています。

📦 インストール

前提条件

• Java 21以上
• Maven 3.8以上
• JDTLSのインストール（例：Homebrewを使って brew install jdtls）

ビルド

mvn clean package

これにより、target/lsp4j - mcp-1.0.0-SNAPSHOT.jar にシェーディングされたJARが作成されます。

💻 使用例

オプション1：スクリプトを実行する

./run.sh /path/to/your/java/project

オプション2：Javaコマンドを直接実行する

java -jar target/lsp4j-mcp-1.0.0-SNAPSHOT.jar <workspace-path> <jdtls-command>

例:

java -jar target/lsp4j-mcp-1.0.0-SNAPSHOT.jar /Users/me/projects/myapp jdtls

オプション3：Claude Code MCPの設定

.mcp.json に以下を追加します。

{
  "mcpServers": {
    "java-lsp": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/LSP4J-MCP/target/lsp4j-mcp-1.0.0-SNAPSHOT.jar",
        "/path/to/your/java/project",
        "jdtls"
      ],
      "env": {
        "LOG_FILE": "/tmp/lsp4j-mcp.log"
      }
    }
  }
}

📚 詳細ドキュメント

プロジェクト構造

LSP4J-MCP/
├── pom.xml                              # Mavenビルド設定
├── run.sh                               # 起動スクリプト
├── mcp-config.json                      # MCP設定の例
├── src/
│   ├── main/
│   │   ├── java/com/devoxx/lsp4jmcp/
│   │   │   ├── client/
│   │   │   │   ├── JdtlsClient.java         # JDTLS用のLSPクライアント
│   │   │   │   └── JdtlsLanguageClient.java # LSPコールバックハンドラー
│   │   │   ├── tools/
│   │   │   │   └── JavaTools.java           # ツールの実装
│   │   │   └── server/
│   │   │       └── McpServerMain.java       # MCPサーバーのエントリーポイント
│   │   └── resources/
│   │       └── logback.xml                  # ログ設定
│   └── test/
│       └── java/com/devoxx/lsp4jmcp/
│           ├── client/JdtlsClientTest.java
│           ├── tools/JavaToolsTest.java
│           └── server/McpServerMainTest.java
└── README.md

テスト

すべてのテストを実行するには、以下のコマンドを実行します。

mvn test

依存関係

• LSP4J - EclipseのJava用Language Server Protocol
• MCP Java SDK - Model Context Protocol SDK
• JDTLS - Eclipse JDT Language Server

サンプルプロンプト

MCPサーバーを設定すると、AIアシスタントにLSPツールをトリガーする質問をすることができます。以下にいくつかの例を示します。

シンボルの検索

"このプロジェクト内でRepositoryという名前のすべてのクラスを見つけて"

"名前に'save'を含むメソッドを検索して"

"UserServiceクラスはどこで定義されているか？"

"このコードベース内のすべてのインターフェースをリストアップして"

参照の検索

"OrderService.javaの45行目にある processOrder メソッドのすべての使用箇所を見つけて"

"CustomerRepository インターフェースがコードベース全体でどこで使用されているか？"

"PaymentGateway.javaの12行目のコンストラクタを呼び出しているすべての場所を表示して"

定義に移動

"CheckoutController.javaの78行目、15列目で呼び出されているメソッドの定義は何か？"

"MyService.javaの23行目にあるインターフェースメソッドの実装に移動して"

ドキュメントシンボル

"Customer.javaファイル内のすべてのメソッドとフィールドをリストアップして"

"src/main/java/com/example/service/OrderService.javaで定義されているシンボルは何か？"

"ConfigurationManager.javaの構造の概要を教えて"

インターフェースメソッドの検索

"findById という名前のメソッドを定義しているインターフェースはどれか？"

"process という名前のメソッドを持つすべてのクラスを見つけて"

"validate メソッドを含むすべてのインターフェースを表示して"

複雑なクエリ

"authenticate メソッドの動作を理解したい。まず定義を見つけ、その後呼び出されているすべての場所を表示して"

"リファクタリングの支援：非推奨の legacyProcess メソッドのすべての使用箇所を見つけて、更新できるようにして"

"新しいRepositoryインターフェースを実装したい。すべての既存のRepositoryインターフェースとそのメソッドを表示して"

ロギング

ログは LOG_FILE 環境変数で指定されたファイルに書き込まれます（デフォルト: /tmp/lsp4j-mcp.log）。

注意: stdoutはMCPプロトコルの通信に予約されているため、すべてのログはファイルに書き込まれます。

アーキテクチャ

Claude Code ──MCP──▶ McpServerMain ──LSP4J──▶ JDTLS ──▶ Java Codebase
                         │
                         ▼
                    JavaTools
                    (find_symbols, find_references, etc.)

サーバーは以下のように動作します。

1. JDTLSをサブプロセスとして起動します。
2. LSP4J（標準入出力を介したJSON - RPC）を介して接続します。
3. LSPの機能をMCPツールとして公開します。
4. MCPプロトコルを介してClaude Codeと通信します。

📄 ライセンス

MIT