Lsp4j MCP

🚀 LSP4J-MCP 服务器

这是一个 Java MCP（模型上下文协议）服务器，它使用 LSP4J 包装 JDTLS（Eclipse JDT 语言服务器），为像 Claude 这样的 AI 助手提供 Java IDE 功能。

🚀 快速开始

本 MCP 服务器可通过以下步骤快速启动，为 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 语言服务器协议
• 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.)

服务器的工作流程如下：

1. 以子进程方式启动 JDTLS
2. 通过 LSP4J（基于标准输入输出的 JSON-RPC）进行连接
3. 将 LSP 功能作为 MCP 工具公开
4. 通过 MCP 协议与 Claude Code 进行通信

📄 许可证

本项目采用 MIT 许可证。