Easy Code Reader
A powerful MCP server for intelligently reading Java source code (For Jar and local project).
What is Easy Code Reader?
Easy Code Reader is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful mcp server for intelligently reading java source code (for jar and local project).
A powerful MCP server for intelligently reading Java source code (For Jar and local project).
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A powerful MCP server for intelligently reading Java source
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx easy-code-readerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Easy Code Reader
Easy Code Reader is an MCP server that gives AI assistants deep access to Java source code, whether it lives in local project directories or inside Maven JAR dependencies. It can decompile or extract sources from JARs in your local Maven repository, browse project file structures, and read individual source files or configs — making it invaluable for understanding multi-module call chains, diagnosing exceptions with full dependency context, and assessing the impact of dependency upgrades.
Prerequisites
- Python 3.10 or higher installed
- Java Development Kit (JDK 8 or higher) available on PATH
- uv package manager installed (https://astral.sh/uv)
- A local Maven repository (defaults to ~/.m2/repository) or custom path
- An MCP-compatible client such as Claude Desktop or Cursor
Install uv package manager
uv is required to run easy-code-reader via uvx. Install it with the official installer script.
curl -LsSf https://astral.sh/uv/install.sh | shVerify Java is available
The server relies on the JDK to decompile JAR files. Confirm java is on your PATH before proceeding.
java -versionTest the server directly
Run the server once with uvx to confirm it starts correctly, substituting your actual Maven repo and project directory paths.
uvx easy-code-reader --maven-repo ~/.m2/repository --project-dir ~/projectsAdd to your MCP client configuration
Open your claude_desktop_config.json (or equivalent config file) and add the easy-code-reader entry under mcpServers with the correct paths for your environment.
Restart your MCP client
Save the configuration file and restart Claude Desktop (or your MCP client) so it picks up the new server. The server exposes five tools: search_artifact, read_jar_source, list_all_project, list_project_files, and read_project_code.
Easy Code Reader Examples
Client configuration
Add this block to your claude_desktop_config.json, replacing the paths with your actual Maven repository and projects directory.
{
"mcpServers": {
"easy-code-reader": {
"command": "uvx",
"args": [
"easy-code-reader",
"--maven-repo", "/Users/yourname/.m2/repository",
"--project-dir", "/Users/yourname/projects"
]
}
}
}Prompts to try
Once connected, use these prompts in Claude to explore Java code with the server's tools.
- "Search for the Spring Boot auto-configuration artifact in my Maven repo and show me how DataSourceAutoConfiguration works."
- "I'm seeing a NullPointerException in com.example.service.UserService.findById — read that source file and explain the issue."
- "List all projects in my project directory and find which ones depend on Jackson 2.14."
- "Read the JAR source for org.springframework:spring-core:6.1.0 and explain the BeanFactory interface."Troubleshooting Easy Code Reader
Server fails to start with 'java not found' or decompilation errors
Ensure a JDK (not just a JRE) is installed and that 'java' is on your PATH. Run 'java -version' to confirm. Set JAVA_HOME if needed.
read_jar_source returns empty results for a dependency
The tool looks for a *-sources.jar first. If none exists in your Maven cache, it falls back to decompilation. Run 'mvn dependency:sources' in your project to download sources jars, or ensure the artifact was published with sources.
list_all_project returns an empty list
Double-check the --project-dir argument points to the parent directory containing your project folders, not to a single project root. Each sub-directory is treated as one project.
Frequently Asked Questions about Easy Code Reader
What is Easy Code Reader?
Easy Code Reader is a Model Context Protocol (MCP) server that powerful mcp server for intelligently reading java source code (for jar and local project). It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Easy Code Reader?
Follow the installation instructions on the Easy Code Reader GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Easy Code Reader?
Easy Code Reader works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Easy Code Reader free to use?
Yes, Easy Code Reader is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Easy Code Reader Alternatives — Similar Developer Tools Servers
Looking for alternatives to Easy Code Reader? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Easy Code Reader in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Easy Code Reader?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.