How do I point Javalens at my Java project?

Set the JAVA_PROJECT_PATH environment variable to your project root before starting the MCP server. It will auto-load on startup. You can also adjust JAVALENS_TIMEOUT_SECONDS if operations are timing out on large codebases.

What Java analysis tools does Javalens provide?

Javalens exposes 63 semantic analysis tools via Eclipse JDT, including code navigation, refactoring suggestions, and code intelligence features like type checking and usage finding.

Can I use Javalens with my IDE at the same time?

Javalens runs as an MCP server over stdio, so it works alongside your IDE. However, check your project's locking behavior—some IDEs may lock files during indexing.

How do I debug what Javalens is doing?

Set JAVALENS_LOG_LEVEL to DEBUG or TRACE before startup to see detailed operation logs. This helps troubleshoot timeouts or unexpected analysis results.

Does Javalens support Gradle, Maven, or both?

The registry metadata does not specify build-system support. Refer to the Javalens documentation or test with your project structure to confirm compatibility.

MCP ServerSTDIOOfficialv1.2.0

JavaLens MCP Server

Analyze and refactor Java code with 63 semantic tools powered by Eclipse JDT. For developers who need IDE-grade code intelligence, navigation, and refactoring in their AI workflows.

io.github.pzalutski-pixel/javalens

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

No auth required

What the JavaLens MCP server does

How models use it and what it is built for.

Analyze and refactor Java code with 63 semantic tools powered by Eclipse JDT. For developers who need IDE-grade code intelligence, navigation, and refactoring in their AI workflows.

Connect to JavaLens

Local install — runs as a subprocess.

npx javalens-mcp@1.2.0

Environment variables

Configuration this server reads at startup.

JAVA_PROJECT_PATH
Auto-load project on startup
JAVALENS_TIMEOUT_SECONDS
Operation timeout in seconds
JAVALENS_LOG_LEVEL
Log level: TRACE, DEBUG, INFO, WARN, ERROR

Resources

Where to find authoritative docs and source for JavaLens.

Source repository

Example prompts for JavaLens

Paste any of these into Agent Studio after connecting JavaLens.

Find all usages of the method getUserById across my Java project
Suggest refactoring opportunities for the PaymentService class
Navigate to the definition of the DatabaseConnection interface
What are the semantic issues or type errors in my codebase

JavaLens MCP server — FAQ

Common questions about connecting and running JavaLens.

How do I point Javalens at my Java project?
Set the JAVA_PROJECT_PATH environment variable to your project root before starting the MCP server. It will auto-load on startup. You can also adjust JAVALENS_TIMEOUT_SECONDS if operations are timing out on large codebases.
What Java analysis tools does Javalens provide?
Javalens exposes 63 semantic analysis tools via Eclipse JDT, including code navigation, refactoring suggestions, and code intelligence features like type checking and usage finding.
Can I use Javalens with my IDE at the same time?
Javalens runs as an MCP server over stdio, so it works alongside your IDE. However, check your project's locking behavior—some IDEs may lock files during indexing.
How do I debug what Javalens is doing?
Set JAVALENS_LOG_LEVEL to DEBUG or TRACE before startup to see detailed operation logs. This helps troubleshoot timeouts or unexpected analysis results.
Does Javalens support Gradle, Maven, or both?
The registry metadata does not specify build-system support. Refer to the Javalens documentation or test with your project structure to confirm compatibility.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio