# Maven Decoder MCP Server
A comprehensive Model Context Protocol (MCP) server for analyzing Maven jar files in your local repository (`~/.m2`). This server provides powerful tools for agentic coding assistance in Java projects, enabling AI agents to understand dependencies, analyze bytecode, extract source code, and navigate the Maven ecosystem.
## 🚀 Features
### Core Functionality
- **Jar File Analysis**: Deep inspection of jar files including metadata, manifests, and structure
- **Dependency Resolution**: Complete dependency tree analysis with transitive dependencies
- **Source Code Extraction**: Extract source code from source jars or decompile bytecode
- **Class Information**: Detailed class signatures, methods, fields, and annotations
- **Search Capabilities**: Find classes, methods, and dependencies across all artifacts
- **Version Management**: Compare versions, find dependents, and track version conflicts
### Advanced Features
- **Decompilation Support**: Integrated support for multiple Java decompilers (CFR, Fernflower, Procyon)
- **Conflict Analysis**: Detect and analyze dependency version conflicts
- **Repository Navigation**: Browse and explore the local Maven repository structure
- **Metadata Parsing**: Extract and parse Maven POM files and metadata
- **Service Discovery**: Find and analyze Java services and SPI implementations
- **Response Management**: Intelligent pagination and summarization for large responses
- **Method Extraction**: Extract specific methods from large Java classes
## 📦 Installation
### Prerequisites
- Java 8+ (for decompilation features)
- Maven local repository (`~/.m2/repository`)
- One of: **Python 3.8+**, **Node.js 14+**, or **Docker**
### 🚀 Quick Install
#### One-Line Install (Recommended)
```bash
curl -fsSL https://raw.githubusercontent.com/salitaba/maven-decoder-mcp/main/install.sh | bash
```
### 📋 Installation Methods
#### Method 1: uvx (Recommended)
```bash
# Install uv (if not installed)
curl -Ls https://astral.sh/uv/install.sh | sh
# Ensure your shell PATH is updated (restart shell or eval as printed by installer)
# Run the server via uvx (isolated, fast, no venv needed)
uvx maven-decoder-mcp
# Optional: pick a specific Python
# uvx --python 3.12 maven-decoder-mcp
```
#### Method 2: Node.js/npm
```bash
# Install globally
npm install -g maven-decoder-mcp
# Or install locally
npm install maven-decoder-mcp
# Run the server
maven-decoder-mcp
# or if installed locally: npx maven-decoder-mcp
```
#### Method 3: Docker
```bash
# Pull and run
docker run --rm -it \
-v ~/.m2:/home/mcpuser/.m2 \
-v $(pwd):/workspace \
ali79taba/maven-decoder-mcp:latest
```
#### Method 4: From Source (Development)
```bash
# Clone repository
git clone https://github.com/salitaba/maven-decoder-mcp.git
cd maven-decoder-mcp
# Option A: Using Virtual Environment
python3 -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
pip install "git+https://github.com/modelcontextprotocol/python-sdk.git"
./setup_decompilers.sh
# Option B: System-wide Installation (not recommended)
./setup_decompilers.sh
```
## 🔧 Configuration
### For Cursor IDE
Add to your `~/.cursor/mcp_servers.json`:
```json
{
"maven-decoder": {
"command": "uvx",
"args": ["maven-decoder-mcp"]
}
}
```
### For Other MCP Clients
The server runs as a standard MCP server and can be integrated with any MCP-compatible client.
## 🛠️ Available Tools
| Tool | Description |
|------|-------------|
| `list_artifacts` | List artifacts in Maven repository with filtering |
| `analyze_jar` | Analyze jar file structure and contents |
| `extract_class_info` | Get detailed information about Java classes |
| `get_dependencies` | Retrieve Maven dependencies from POM files |
| `search_classes` | Search for classes across all jars |
| `extract_source_code` | Decompile and extract Java source code |
| `compare_versions` | Compare different versions of artifacts |
| `find_usage_examples` | Find usage examples in test code |
| `get_dependency_tree` | Get complete dependency tree |
| `find_dependents` | Find artifacts that depend on a specific artifact |
| `get_version_info` | Get all available versions of an artifact |
| `analyze_jar_structure` | Analyze overall jar structure and metadata |
| `extract_method_info` | Extract specific method information from Java classes |
## 💡 Usage Examples
### Finding Dependencies
```
"Show me all dependencies of org.springframework:spring-core:5.3.21"
```
### Decompiling Classes
```
"Decompile the class com.example.MyService from my Maven repository"
```
### Analyzing Conflicts
```
"Find all version conflicts in my Maven repository"
```
### Exploring APIs
```
"Show me all public methods in the Jackson ObjectMapper class"
```
### Working with Large Responses
```
"List all Spring classes with pagination (page 2, 10 items per page)"
"Extract source code for a large class with summarization"
"Get method information for specific patterns in a class"
```
## 🔄 Response Management
### Pagination Support
The server automatically handles large responses through intelligent pagination:
- **Automatic Detection**: Responses exceeding 50KB are automatically paginated
- **Configurable Page Size**: Default 20 items per page, customizable per request
- **Pagination Metadata**: Each response includes pagination information
- **Supported Tools**: `list_artifacts`, `extract_class_info`, `search_classes`, `get_dependencies`, `find_dependents`, `get_version_info`
### Summarization Features
Large text content is automatically summarized to improve readability:
- **Smart Summarization**: Preserves important parts (package declarations, method signatures, closing braces)
- **Configurable Limits**: Default 10KB text limit, customizable
- **Java-Specific**: Optimized for Java source code structure
- **Metadata Preservation**: Original structure and metadata are maintained
### Method Extraction
New tool for targeted access to specific methods:
- **Pattern Matching**: Use regex patterns to find specific methods
- **Limited Results**: Control the number of methods returned
- **Full Context**: Includes method signatures, bodies, and line numbers
- **Efficient Processing**: Only extracts requested methods, not entire classes
## 🏗️ Architecture
The server is built with a modular architecture:
- **`MavenDecoderServer`**: Main MCP server implementation
- **`ResponseManager`**: Handles pagination and summarization
- **`JavaDecompiler`**: Handles multiple decompilation strategies
- **`MavenDependencyAnalyzer`**: Analyzes Maven dependencies and metadata
- **Decompilers**: CFR, Procyon, Fernflower, and javap integration
## 🧪 Development
### Running Tests
```bash
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Run specific test
python test_startup.py
```
### Building Package
```bash
# Build distribution
python setup.py sdist bdist_wheel
# Install locally
pip install dist/maven_decoder_mcp-*.whl
```
### Docker Development
```bash
# Build Docker image
docker build -t maven-decoder-mcp .
# Run container
docker run --rm -it maven-decoder-mcp
```
## 📝 Configuration Options
### Environment Variables
- `MAVEN_HOME`: Custom Maven repository location (default: `~/.m2/repository`)
- `MCP_LOG_LEVEL`: Logging level (DEBUG, INFO, WARNING, ERROR)
- `MCP_MAX_RESPONSE_SIZE`: Maximum response size in bytes (default: 50000)
- `MCP_MAX_ITEMS_PER_PAGE`: Default items per page (default: 20)
- `MCP_MAX_TEXT_LENGTH`: Maximum text length before summarization (default: 10000)
- `MCP_MAX_LINES`: Maximum lines before summarization (default: 500)
### Advanced Configuration
The server automatically detects and configures:
- Maven repository location
- Available Java decompilers
- System capabilities
## 🔍 Troubleshooting
### Common Issues
**Server won't start**
```bash
# Check Python installation
python --version
# Check Maven repository
ls ~/.m2/repository
# Check logs
maven-decoder-mcp --debug
```
**Decompilation fails**
```bash
# Check Java installation
java -version
# Setup decompilers manually
maven-decoder-setup decompilers
```
**No artifacts found**
```bash
# Verify Maven repository location
ls ~/.m2/repository
# Run a Maven build to populate repository
mvn dependency:resolve
```
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [Model Context Protocol](https://github.com/modelcontextprotocol) - The protocol that powers this server
- [CFR](https://github.com/leibnitz27/cfr) - Java decompiler
- [Procyon](https://github.com/mstrobel/procyon) - Java decompiler
- [Maven](https://maven.apache.org/) - Dependency management
## 📊 Stats
---
**Made with ❤️ for the Java development community**
Raw data
{
"_id": null,
"home_page": null,
"name": "maven-decoder-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Ali Tabatabaei <ali79taba@gmail.com>",
"keywords": "mcp, maven, java, decompiler, jar, analysis, cursor, ide",
"author": null,
"author_email": "Ali Tabatabaei <ali79taba@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d5/ed/8283424c0786ab23ad80d6f66b9b41bca92ce9afa6b6fe1b7313134e72e3/maven_decoder_mcp-1.0.23.tar.gz",
"platform": null,
"description": "# Maven Decoder MCP Server\n\nA comprehensive Model Context Protocol (MCP) server for analyzing Maven jar files in your local repository (`~/.m2`). This server provides powerful tools for agentic coding assistance in Java projects, enabling AI agents to understand dependencies, analyze bytecode, extract source code, and navigate the Maven ecosystem.\n\n## \ud83d\ude80 Features\n\n### Core Functionality\n- **Jar File Analysis**: Deep inspection of jar files including metadata, manifests, and structure\n- **Dependency Resolution**: Complete dependency tree analysis with transitive dependencies\n- **Source Code Extraction**: Extract source code from source jars or decompile bytecode\n- **Class Information**: Detailed class signatures, methods, fields, and annotations\n- **Search Capabilities**: Find classes, methods, and dependencies across all artifacts\n- **Version Management**: Compare versions, find dependents, and track version conflicts\n\n### Advanced Features\n- **Decompilation Support**: Integrated support for multiple Java decompilers (CFR, Fernflower, Procyon)\n- **Conflict Analysis**: Detect and analyze dependency version conflicts\n- **Repository Navigation**: Browse and explore the local Maven repository structure\n- **Metadata Parsing**: Extract and parse Maven POM files and metadata\n- **Service Discovery**: Find and analyze Java services and SPI implementations\n- **Response Management**: Intelligent pagination and summarization for large responses\n- **Method Extraction**: Extract specific methods from large Java classes\n\n## \ud83d\udce6 Installation\n\n### Prerequisites\n- Java 8+ (for decompilation features)\n- Maven local repository (`~/.m2/repository`)\n- One of: **Python 3.8+**, **Node.js 14+**, or **Docker**\n\n### \ud83d\ude80 Quick Install\n\n#### One-Line Install (Recommended)\n```bash\ncurl -fsSL https://raw.githubusercontent.com/salitaba/maven-decoder-mcp/main/install.sh | bash\n```\n\n### \ud83d\udccb Installation Methods\n\n#### Method 1: uvx (Recommended)\n```bash\n# Install uv (if not installed)\ncurl -Ls https://astral.sh/uv/install.sh | sh\n# Ensure your shell PATH is updated (restart shell or eval as printed by installer)\n\n# Run the server via uvx (isolated, fast, no venv needed)\nuvx maven-decoder-mcp\n\n# Optional: pick a specific Python\n# uvx --python 3.12 maven-decoder-mcp\n```\n\n#### Method 2: Node.js/npm\n```bash\n# Install globally\nnpm install -g maven-decoder-mcp\n\n# Or install locally\nnpm install maven-decoder-mcp\n\n# Run the server\nmaven-decoder-mcp\n# or if installed locally: npx maven-decoder-mcp\n```\n\n#### Method 3: Docker\n```bash\n# Pull and run\ndocker run --rm -it \\\n -v ~/.m2:/home/mcpuser/.m2 \\\n -v $(pwd):/workspace \\\n ali79taba/maven-decoder-mcp:latest\n```\n\n#### Method 4: From Source (Development)\n```bash\n# Clone repository\ngit clone https://github.com/salitaba/maven-decoder-mcp.git\ncd maven-decoder-mcp\n\n# Option A: Using Virtual Environment\npython3 -m venv .venv\nsource .venv/bin/activate # On Windows: .venv\\Scripts\\activate\npip install -r requirements.txt\npip install \"git+https://github.com/modelcontextprotocol/python-sdk.git\"\n./setup_decompilers.sh\n\n# Option B: System-wide Installation (not recommended)\n./setup_decompilers.sh\n```\n\n## \ud83d\udd27 Configuration\n\n### For Cursor IDE\nAdd to your `~/.cursor/mcp_servers.json`:\n\n```json\n{\n \"maven-decoder\": {\n \"command\": \"uvx\",\n \"args\": [\"maven-decoder-mcp\"]\n }\n}\n```\n\n### For Other MCP Clients\nThe server runs as a standard MCP server and can be integrated with any MCP-compatible client.\n\n## \ud83d\udee0\ufe0f Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_artifacts` | List artifacts in Maven repository with filtering |\n| `analyze_jar` | Analyze jar file structure and contents |\n| `extract_class_info` | Get detailed information about Java classes |\n| `get_dependencies` | Retrieve Maven dependencies from POM files |\n| `search_classes` | Search for classes across all jars |\n| `extract_source_code` | Decompile and extract Java source code |\n| `compare_versions` | Compare different versions of artifacts |\n| `find_usage_examples` | Find usage examples in test code |\n| `get_dependency_tree` | Get complete dependency tree |\n| `find_dependents` | Find artifacts that depend on a specific artifact |\n| `get_version_info` | Get all available versions of an artifact |\n| `analyze_jar_structure` | Analyze overall jar structure and metadata |\n| `extract_method_info` | Extract specific method information from Java classes |\n\n## \ud83d\udca1 Usage Examples\n\n### Finding Dependencies\n```\n\"Show me all dependencies of org.springframework:spring-core:5.3.21\"\n```\n\n### Decompiling Classes\n```\n\"Decompile the class com.example.MyService from my Maven repository\"\n```\n\n### Analyzing Conflicts\n```\n\"Find all version conflicts in my Maven repository\"\n```\n\n### Exploring APIs\n```\n\"Show me all public methods in the Jackson ObjectMapper class\"\n```\n\n### Working with Large Responses\n```\n\"List all Spring classes with pagination (page 2, 10 items per page)\"\n\"Extract source code for a large class with summarization\"\n\"Get method information for specific patterns in a class\"\n```\n\n## \ud83d\udd04 Response Management\n\n### Pagination Support\nThe server automatically handles large responses through intelligent pagination:\n\n- **Automatic Detection**: Responses exceeding 50KB are automatically paginated\n- **Configurable Page Size**: Default 20 items per page, customizable per request\n- **Pagination Metadata**: Each response includes pagination information\n- **Supported Tools**: `list_artifacts`, `extract_class_info`, `search_classes`, `get_dependencies`, `find_dependents`, `get_version_info`\n\n### Summarization Features\nLarge text content is automatically summarized to improve readability:\n\n- **Smart Summarization**: Preserves important parts (package declarations, method signatures, closing braces)\n- **Configurable Limits**: Default 10KB text limit, customizable\n- **Java-Specific**: Optimized for Java source code structure\n- **Metadata Preservation**: Original structure and metadata are maintained\n\n### Method Extraction\nNew tool for targeted access to specific methods:\n\n- **Pattern Matching**: Use regex patterns to find specific methods\n- **Limited Results**: Control the number of methods returned\n- **Full Context**: Includes method signatures, bodies, and line numbers\n- **Efficient Processing**: Only extracts requested methods, not entire classes\n\n## \ud83c\udfd7\ufe0f Architecture\n\nThe server is built with a modular architecture:\n\n- **`MavenDecoderServer`**: Main MCP server implementation\n- **`ResponseManager`**: Handles pagination and summarization\n- **`JavaDecompiler`**: Handles multiple decompilation strategies\n- **`MavenDependencyAnalyzer`**: Analyzes Maven dependencies and metadata\n- **Decompilers**: CFR, Procyon, Fernflower, and javap integration\n\n## \ud83e\uddea Development\n\n### Running Tests\n```bash\n# Install development dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Run specific test\npython test_startup.py\n```\n\n### Building Package\n```bash\n# Build distribution\npython setup.py sdist bdist_wheel\n\n# Install locally\npip install dist/maven_decoder_mcp-*.whl\n```\n\n### Docker Development\n```bash\n# Build Docker image\ndocker build -t maven-decoder-mcp .\n\n# Run container\ndocker run --rm -it maven-decoder-mcp\n```\n\n## \ud83d\udcdd Configuration Options\n\n### Environment Variables\n- `MAVEN_HOME`: Custom Maven repository location (default: `~/.m2/repository`)\n- `MCP_LOG_LEVEL`: Logging level (DEBUG, INFO, WARNING, ERROR)\n- `MCP_MAX_RESPONSE_SIZE`: Maximum response size in bytes (default: 50000)\n- `MCP_MAX_ITEMS_PER_PAGE`: Default items per page (default: 20)\n- `MCP_MAX_TEXT_LENGTH`: Maximum text length before summarization (default: 10000)\n- `MCP_MAX_LINES`: Maximum lines before summarization (default: 500)\n\n### Advanced Configuration\nThe server automatically detects and configures:\n- Maven repository location\n- Available Java decompilers\n- System capabilities\n\n## \ud83d\udd0d Troubleshooting\n\n### Common Issues\n\n**Server won't start**\n```bash\n# Check Python installation\npython --version\n\n# Check Maven repository\nls ~/.m2/repository\n\n# Check logs\nmaven-decoder-mcp --debug\n```\n\n\n\n**Decompilation fails**\n```bash\n# Check Java installation\njava -version\n\n# Setup decompilers manually\nmaven-decoder-setup decompilers\n```\n\n**No artifacts found**\n```bash\n# Verify Maven repository location\nls ~/.m2/repository\n\n# Run a Maven build to populate repository\nmvn dependency:resolve\n```\n\n## \ud83e\udd1d Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- [Model Context Protocol](https://github.com/modelcontextprotocol) - The protocol that powers this server\n- [CFR](https://github.com/leibnitz27/cfr) - Java decompiler\n- [Procyon](https://github.com/mstrobel/procyon) - Java decompiler\n- [Maven](https://maven.apache.org/) - Dependency management\n\n## \ud83d\udcca Stats\n\n\n\n\n\n---\n\n**Made with \u2764\ufe0f for the Java development community**\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for reading and decompiling Maven .m2 jar files with comprehensive Java project analysis",
"version": "1.0.23",
"project_urls": {
"Bug Tracker": "https://github.com/salitaba/maven-decoder-mcp/issues",
"Documentation": "https://github.com/salitaba/maven-decoder-mcp#readme",
"Homepage": "https://github.com/salitaba/maven-decoder-mcp",
"Repository": "https://github.com/salitaba/maven-decoder-mcp.git"
},
"split_keywords": [
"mcp",
" maven",
" java",
" decompiler",
" jar",
" analysis",
" cursor",
" ide"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6cea6ec7805455dffca5f91f1c7dc56b10437b3f71482db2ad201c1f6b599a64",
"md5": "3144b7dbb6d951eaf98bf177603fe078",
"sha256": "3e329038892f9848b35c25dcf60545e04c793a44f9e168a936f8075f404bbc31"
},
"downloads": -1,
"filename": "maven_decoder_mcp-1.0.23-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3144b7dbb6d951eaf98bf177603fe078",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 33108,
"upload_time": "2025-08-31T15:02:20",
"upload_time_iso_8601": "2025-08-31T15:02:20.284901Z",
"url": "https://files.pythonhosted.org/packages/6c/ea/6ec7805455dffca5f91f1c7dc56b10437b3f71482db2ad201c1f6b599a64/maven_decoder_mcp-1.0.23-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d5ed8283424c0786ab23ad80d6f66b9b41bca92ce9afa6b6fe1b7313134e72e3",
"md5": "1b57b25f0fd684d23e1357160b604fe0",
"sha256": "c142862478852eaf8e2a2c4d5cda04f281952e4c9a20a991d8b44c1627840c25"
},
"downloads": -1,
"filename": "maven_decoder_mcp-1.0.23.tar.gz",
"has_sig": false,
"md5_digest": "1b57b25f0fd684d23e1357160b604fe0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 34813,
"upload_time": "2025-08-31T15:02:21",
"upload_time_iso_8601": "2025-08-31T15:02:21.457944Z",
"url": "https://files.pythonhosted.org/packages/d5/ed/8283424c0786ab23ad80d6f66b9b41bca92ce9afa6b6fe1b7313134e72e3/maven_decoder_mcp-1.0.23.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 15:02:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "salitaba",
"github_project": "maven-decoder-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": null,
"specs": []
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "xmltodict",
"specs": [
[
">=",
"0.13.0"
]
]
},
{
"name": "javatools",
"specs": [
[
">=",
"1.4.0"
]
]
},
{
"name": "py4j",
"specs": [
[
">=",
"0.10.9"
]
]
},
{
"name": "aiofiles",
"specs": [
[
">=",
"23.0.0"
]
]
},
{
"name": "pathspec",
"specs": [
[
">=",
"0.11.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.25.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "pytest-asyncio",
"specs": [
[
">=",
"0.21.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"4.0.0"
]
]
}
],
"lcname": "maven-decoder-mcp"
}
JSON
