Which integrations are available for this server?

Supports Gradle-based Java projects, providing workspace and dependency navigation, diagnostics, compilation, tests, and refactoring previews for Gradle project structures.

How do I use java-lsp-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@java-lsp-mcp find affected tests for the change in PaymentService.java" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

java-lsp-mcp

Java semantic intelligence for Model Context Protocol (MCP) clients, powered by Eclipse JDT Language Server and ECJ.

java-lsp-mcp gives coding agents semantic navigation, diagnostics, compilation, tests, and refactoring previews. It never edits source files: changes are returned as hash-bound edits and optional diffs for the client to apply.

Features

Workspace and dependency navigation
Maven, Gradle, Eclipse, modular, and unmanaged projects
Current-snapshot diagnostics and ECJ compilation
Parallel JUnit tests, suspended JDWP test launches, affected-test discovery, and JaCoCo coverage
Read-only fixes, refactorings, import, and formatting previews
Bounded, paginated agent-friendly results

Related MCP server: JDTLS-MCP

Requirements

Release archives bundle Node.js and JDT LS; provide a JDK through JAVA_HOME or --tooling-jdk. Source builds require Node.js 24 and npm.

Quick start

npm ci
npm run fetch-runtime
npm run check
bin/java-lsp-mcp serve --workspace /absolute/path/to/project --trust-workspace

On Windows use bin\java-lsp-mcp.cmd. Run java-lsp-mcp doctor --workspace /project to check setup. See Getting started for client configuration and trust guidance.

Tools

Tool	Purpose
`java_status`	Readiness and runtime status
`java_outline`	Source declarations
`java_search_symbols`	Workspace and dependency symbols
`java_find_definition`	Symbol declarations
`java_find_references`	Semantic usages
`java_call_hierarchy`	Callers and callees; incoming callers default to production scope
`java_type_hierarchy`	Supertypes, subtypes, implementations
`java_diagnostics`	Current-snapshot diagnostics
`java_compile`	ECJ workspace compilation with automatic loaded-prerequisite recovery
`java_run_tests`	JUnit execution or suspended JDWP debug launch (`debug: true`)
`java_find_affected_tests`	Statically connected tests
`java_find_unused_code`	Candidate unused private members
`java_code_actions`	Available fixes and refactorings
`java_edit_preview`	Rename, action, import, format previews
`java_debug_targets`	Discover local JVMs started with the JDWP agent
`java_debug_attach`, `java_debug_sessions`, `java_debug_detach`	JDWP debug-session lifecycle
`java_debug_set_breakpoints`, `java_debug_wait_for_stop`	Source breakpoints and bounded stop-event waits
`java_debug_threads`, `java_debug_stack_trace`, `java_debug_variables`	Filtered runtime thread/stack, local, collection, and object inspection
`java_debug_execute`	Continue and step over, into, or out
`java_debug_hot_swap`	ECJ/JDI Hot Code Replace with change and active-frame reporting

See the tool reference or run java-lsp-mcp describe-tools.

Documentation

Contributing

Contributions are welcome. See CONTRIBUTING.md.

Security

Review SECURITY.md before granting workspace trust. Report vulnerabilities privately.

License

MIT. See LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

JAIPilot
io.github.JAIPilot
Ship better Java with your coding agent.
Coding Agents Developer Tools Code Analysis
14
Maguyva
ai.maguyva
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Code Analysis Coding Agents
23
ContextStream MCP ServerOAuth
io.github.contextstream
Project memory, semantic code search, and grounded agent context.
Knowledge & Memory Code Analysis RAG Systems
143
Brain ScannerOAuth
io.github.kevin-lozada-santos
Codebase graphs, caller impact analysis, and recorded project context for AI coding agents.
Code Analysis Developer Tools Knowledge & Memory
1

Related MCP Servers

jons-mcp-java
Developer Tools Code Analysis
jonmmease
A
license
B
quality
C
maintenance
Provides Java development capabilities through Eclipse JDT.LS, enabling symbol navigation, code diagnostics, workspace searching, and Javadoc access across Java projects.
Updated 3 months ago (2026-06-02 15:58 UTC)
10
MIT
JDTLS-MCP
Code Analysis Developer Tools
sunix
A
license
Not graded
quality
B
maintenance
Exposes Eclipse JDT Language Server to AI agents via MCP. Embedded OSGi architecture runs jdtls in the same JVM — no subprocess, no network hop. Tools: hover, definition, references, completion, diagnostics, document & workspace symbols.
Updated 7 days ago (2026-09-08 09:46 UTC)
4
Eclipse Public 2.0
LSP MCP
Code Analysis Developer Tools
jonrad
A
license
Not graded
quality
D
maintenance
Provides AI agents with language-aware code analysis through the Language Server Protocol, enabling tasks like getting code insights and diagnostics.
Updated a year ago (2025-03-31 21:04 UTC)
9 npm
191
MIT
ACE-MCP
Code Analysis Search RAG Systems
0215AndrewFeng
A
license
Not graded
quality
B
maintenance
Enables AI clients to perform local code search, indexing, and analysis across Java, JavaScript/TypeScript, .NET/C#, and Python projects through the MCP protocol.
Updated 19 days ago (2026-08-28 03:01 UTC)
1
Apache 2.0