lsp4j-mcp - 基於LSP4J和JDTLS的Java MCP服務器，為AI助手提供代碼智能分析集成工具

探索

Lsp4j MCP

一個基於LSP4J和JDTLS的Java MCP服務器，為AI助手提供Java代碼智能分析功能，包括符號查找、引用追蹤、定義跳轉等IDE工具。

開發者工具人工智能聊天機器人 #Java代碼分析 #IDE工具集成 #符號查找 #引用追蹤 .Java

評分 : 2.5分

下載量 : 7.4K

更新時間 : 2026-03-13

打開站點

什麼是LSP4J-MCP服務器?

LSP4J-MCP服務器是一個智能橋樑，它連接了專業的Java開發工具(JDTLS)和AI助手(如Claude)。通過這個服務器，AI助手可以像專業開發者一樣理解Java代碼結構：查找類定義、追蹤方法調用、分析代碼引用關係等。

如何使用LSP4J-MCP服務器?

您只需配置一次服務器連接，之後就可以直接向AI助手提問關於Java代碼的問題。例如：'這個項目中所有名為Repository的類在哪裡？'或'這個方法在哪些地方被調用了？'。服務器會自動處理技術細節，讓您專注於代碼理解。

適用場景

適用於需要理解複雜Java項目的開發者、代碼審查、重構輔助、新成員熟悉代碼庫、以及需要深度代碼分析的場景。特別適合大型企業級Java應用。

主要功能

智能符號查找

按名稱搜索Java代碼中的各種符號：類、接口、方法、字段等。支持模糊匹配和精確查找。

引用追蹤

追蹤代碼中的引用關係，找到某個方法、類或變量在項目中的所有使用位置。

跳轉到定義

快速定位符號的原始定義位置，無論是類定義、方法實現還是變量聲明。

文檔符號分析

分析單個Java文件中的所有符號結構，提供文件的完整大綱視圖。

接口方法搜索

查找包含特定方法名的所有接口，便於理解接口契約和實現關係。

優勢

專業級代碼分析：基於Eclipse JDTLS，提供與專業IDE同級的代碼理解能力

無需手動瀏覽代碼：AI助手可以快速回答覆雜的代碼結構問題

支持大型項目：能夠處理企業級規模的Java代碼庫

標準化協議：使用MCP協議，與多種AI助手兼容

即時分析：連接即時語言服務器，獲取最新的代碼信息

侷限性

需要Java開發環境：需要安裝Java 21+和JDTLS

初始配置較複雜：需要正確配置工作空間路徑

僅支持Java語言：專注於Java生態系統

依賴外部進程：需要運行JDTLS語言服務器進程

學習曲線：需要了解基本的MCP配置概念

如何使用

環境準備

確保系統已安裝Java 21或更高版本，並安裝JDTLS語言服務器。可以通過Homebrew安裝：brew install jdtls

構建服務器

使用Maven構建LSP4J-MCP服務器，生成可執行的JAR文件。

配置MCP連接

在您的MCP客戶端配置文件中添加服務器配置，指定Java項目路徑和服務器命令。

啟動並使用

啟動MCP客戶端，現在您可以直接向AI助手提問關於Java代碼的問題了。

使用案例

代碼導航與理解

當您需要快速瞭解一個大型Java項目的結構時，可以直接詢問AI關於代碼組織的問題。

重構輔助

在重構代碼時，需要了解某個方法或類的所有使用位置，確保修改不會破壞現有功能。

新功能開發

開發新功能時，需要了解現有的接口契約和實現模式。

代碼審查

審查代碼時，需要快速理解類的依賴關係和使用模式。

常見問題

我需要安裝完整的Eclipse IDE嗎？

服務器支持哪些Java版本？

如何處理多模塊的Maven或Gradle項目？

服務器會影響我的開發環境嗎？

為什麼需要配置LOG_FILE環境變量？

服務器支持即時代碼變更檢測嗎？

🚀 LSP4J-MCP 服務器

這是一個 Java MCP（模型上下文協議）服務器，它使用 LSP4J 包裝 JDTLS（Eclipse JDT 語言服務器），為像 Claude 這樣的 AI 助手提供 Java IDE 功能。

🚀 快速開始

本 MCP 服務器可通過以下步驟快速啟動，為 AI 助手提供 Java IDE 功能。

✨ 主要特性

此 MCP 服務器提供了以下工具：

工具	描述
`find_symbols`	按名稱搜索 Java 符號（類、方法、字段）
`find_references`	查找給定文件位置中符號的所有引用
`find_definition`	跳轉到符號的定義處
`document_symbols`	獲取 Java 文件中定義的所有符號
`find_interfaces_with_method`	查找包含指定名稱方法的所有接口

📦 安裝指南

前提條件

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 語言服務器協議
MCP Java SDK - 模型上下文協議 SDK
JDTLS - Eclipse JDT 語言服務器

示例提示

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）。

注意：標準輸出用於 MCP 協議通信，因此所有日誌都寫入文件。

架構

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

服務器的工作流程如下：