Maven Decoder
MCP server for inspecting, searching, and decompiling Maven .m2 JARs for Java AI coding agents.
What is Maven Decoder?
Maven Decoder is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for inspecting, searching, and decompiling maven .m2 jars for java ai coding agents.
MCP server for inspecting, searching, and decompiling Maven .m2 JARs for Java AI coding agents.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for inspecting, searching, and decompiling Maven
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx maven-decoderConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Maven Decoder
Maven Decoder MCP Server is a developer tool that lets AI coding agents inspect, search, and decompile JAR files from your local Maven .m2 repository. It exposes 14 tools covering dependency trees, class extraction, source code decompilation (via CFR, Fernflower, or Procyon), method-level introspection, version comparisons, and conflict detection. Java developers use it to give AI assistants like Claude deep knowledge of their third-party dependencies without manually extracting and sharing JAR contents.
Prerequisites
- A populated Maven local repository at ~/.m2/repository (generated by running Maven builds)
- Python 3.9+ with pip or uvx available, OR Docker installed for the container-based setup
- Java Runtime Environment (JRE) 11+ for decompiler support
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Install Maven Decoder via the install script
The quickest way to install is using the provided shell script, which handles Python dependencies and sets up the server automatically.
curl -fsSL https://raw.githubusercontent.com/salitaba/maven-decoder-mcp/main/install.sh | bashAlternative: run via uvx or Docker
If you prefer uvx for isolated Python execution, use the uvx command directly. For Docker, mount your local .m2 repository into the container.
# Via uvx:
uvx maven-decoder-mcp
# Via Docker:
docker run --rm -it -v ~/.m2:/home/mcpuser/.m2 ali79taba/maven-decoder-mcp:latestConfigure environment variables (optional)
Set optional environment variables to customize the server behavior such as the Maven home directory, log verbosity, response size limits, and pagination settings.
export MAVEN_HOME=~/.m2/repository
export MCP_LOG_LEVEL=INFO
export MCP_MAX_RESPONSE_SIZE=50000
export MCP_MAX_ITEMS_PER_PAGE=20
export MCP_MAX_TEXT_LENGTH=10000
export MCP_MAX_LINES=500Add the server to your MCP client configuration
Register Maven Decoder in your MCP client config file. Point the command to uvx or the installed binary so your AI client launches it automatically.
{
"mcpServers": {
"maven-decoder": {
"command": "uvx",
"args": ["maven-decoder-mcp"],
"env": {
"MAVEN_HOME": "/Users/yourname/.m2/repository",
"MCP_LOG_LEVEL": "INFO"
}
}
}
}Restart your MCP client and test the connection
Restart your AI client and confirm the 14 Maven Decoder tools are listed. Try a simple query like listing artifacts in a known group to verify the .m2 path is correct.
Maven Decoder Examples
Client configuration
Example claude_desktop_config.json entry for Maven Decoder using uvx with a custom Maven repository path.
{
"mcpServers": {
"maven-decoder": {
"command": "uvx",
"args": ["maven-decoder-mcp"],
"env": {
"MAVEN_HOME": "/Users/yourname/.m2/repository",
"MCP_MAX_RESPONSE_SIZE": "50000",
"MCP_MAX_ITEMS_PER_PAGE": "20"
}
}
}
}Prompts to try
Example prompts for Java developers using Maven Decoder with an AI assistant.
- "Show me all dependencies of org.springframework:spring-core:5.3.21"
- "Decompile the class com.example.MyService from my Maven repository"
- "Find all version conflicts in my Maven dependency tree"
- "List all artifacts in the com.fasterxml.jackson.core group"
- "Extract the method signatures from JsonParser in jackson-core 2.15.0"Troubleshooting Maven Decoder
Server cannot find JARs in the .m2 repository
Set the MAVEN_HOME environment variable explicitly to your actual repository path (e.g. /Users/yourname/.m2/repository). The default assumes the standard location; non-standard Maven installs may have a different path.
Decompilation fails or returns garbled output
Ensure a JRE 11 or higher is installed and accessible in your PATH. The decompilers (CFR, Fernflower, Procyon) require a working Java runtime. Run 'java -version' to confirm.
Responses are truncated for large classes
Increase MCP_MAX_TEXT_LENGTH and MCP_MAX_LINES environment variables in your MCP config. Alternatively, use the extract_method_info tool to retrieve specific methods rather than the entire decompiled class.
Frequently Asked Questions about Maven Decoder
What is Maven Decoder?
Maven Decoder is a Model Context Protocol (MCP) server that mcp server for inspecting, searching, and decompiling maven .m2 jars for java ai coding agents. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Maven Decoder?
Follow the installation instructions on the Maven Decoder GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Maven Decoder?
Maven Decoder works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Maven Decoder free to use?
Yes, Maven Decoder is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Maven Decoder Alternatives — Similar Developer Tools Servers
Looking for alternatives to Maven Decoder? 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 Maven Decoder 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 Maven Decoder?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.