mvn-mcp-server


Namemvn-mcp-server JSON
Version 2.2.2 PyPI version JSON
download
home_pageNone
SummaryA MCP server for Maven dependency version checking
upload_time2025-10-15 18:25:07
maintainerNone
docs_urlNone
authorDaniel Scholl
requires_python>=3.12
licenseMIT
keywords mcp maven model-context-protocol dependency-management
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Maven MCP Server

[![CI](https://github.com/danielscholl/mvn-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/danielscholl/mvn-mcp-server/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/danielscholl/mvn-mcp-server)](https://github.com/danielscholl/mvn-mcp-server/releases)
[![Python](https://img.shields.io/badge/python-3.12%20|%203.13-blue)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-green)](https://modelcontextprotocol.io)

**AI-powered Maven dependency management through natural language.**

Maven MCP Server enables AI assistants to interact with Maven Central repository, providing comprehensive tools for version checking, security scanning, and dependency analysis—all through conversational interfaces.

## Why Maven MCP Server?

**Traditional Maven workflow:**
```bash
mvn versions:display-dependency-updates  # Check all dependencies
# Read through XML output, manually check each update
# Manually verify security advisories
# Repeat for each project...
```

**With Maven MCP Server:**
```
You: "Scan this project for vulnerabilities and create an update plan"
AI: ✅ Found 3 critical CVEs, 12 outdated dependencies
    📋 Created prioritized update plan with file locations
    🎯 Ready to implement
```

> **Key Benefits:**
> - Natural language instead of complex Maven commands
> - Single workflow combining version checks + security + planning
> - AI-assisted decision making with full context
> - Intelligent caching for faster repeated queries
> - Enterprise-ready with audit trails and traceability

## Features

| Category | Capabilities |
|----------|-------------|
| **Version Management** | Check single or batch dependency versions • Discover available updates (major/minor/patch) • List version history grouped by tracks |
| **Security Scanning** | Integrate Trivy vulnerability scanning • CVE detection with severity filtering • Multi-module project support • Profile-based scanning for multi-cloud deployments |
| **Enterprise Workflows** | Guided dependency triage analysis • Actionable remediation planning • Complete audit trail with CVE traceability |
| **AI-Optimized** | Single-call comprehensive responses • Batch operations for efficiency • Intelligent caching |

## Quick Start

**Prerequisites:**

- [Python 3.12+](https://www.python.org/downloads/)
- [uv](https://docs.astral.sh/uv/getting-started/installation/)
- [trivy](https://trivy.dev) (optional, for security scanning)
- [maven](https://maven.apache.org/install.html) (optional, for profile-based scanning)


### Setup

[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22mvn-mcp-server%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mvn-mcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)


```bash
mcp add mvn-mcp-server -- uvx mvn-mcp-server
```

Or add manually to your MCP configuration:

```json
{
  "mcpServers": {
    "mvn-mcp-server": {
      "command": "uvx",
      "args": ["mvn-mcp-server"]
    }
  }
}
```


### Try It

> "Check if Spring Core 5.3.0 has any updates available"

> "Scan my Java project for security vulnerabilities"


### Optional: Security Scanning

Install **Trivy** for vulnerability detection:

```bash
# macOS
brew install trivy

# Linux
# See: https://aquasecurity.github.io/trivy/latest/getting-started/installation/
```

Without Trivy, version checking and dependency analysis work normally. Security scanning tools will gracefully report Trivy unavailable.

**Security Note:** All processing happens locally. No source code or project data is sent to external services (except public Maven Central API queries for version information).

## Available Tools

| Tool | Description | Example Query |
|------|-------------|---------------|
| **check_version_tool** | Check single dependency version | `Check org.springframework:spring-core version 5.3.0` |
| **check_version_batch_tool** | Check multiple dependencies | `Check these for updates: spring-core 5.3.0, junit 4.13.2` |
| **list_available_versions_tool** | List version history by tracks | `Show all versions of commons-lang3` |
| **scan_java_project_tool** | Security scan with Trivy | `Scan this project for vulnerabilities` |
| **analyze_pom_file_tool** | Analyze POM file | `Analyze this pom.xml for issues` |

## Available Prompts

| Prompt | Description | Example Query |
|--------|-------------|---------------|
| **list_mcp_assets_prompt** | Show all capabilities with examples | `What can this server do?` |
| **triage** | Complete dependency and vulnerability analysis | `Run triage for my-service` |
| **plan** | Generate actionable remediation plan | `Create update plan for my-service` |

## License

This project is licensed under the MIT License - see [LICENSE](LICENSE) for details.

---

<div align="center">

**[Usage](https://github.com/danielscholl/mvn-mcp-server/blob/main/docs/project-usage.md)** • **[Architecture](https://github.com/danielscholl/mvn-mcp-server/blob/main/docs/project-architect.md)** • **[Contributing](https://github.com/danielscholl/mvn-mcp-server/blob/main/CONTRIBUTING.md)**

</div>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mvn-mcp-server",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": "Daniel Scholl <daniel.scholl@microsoft.com>",
    "keywords": "mcp, maven, model-context-protocol, dependency-management",
    "author": "Daniel Scholl",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/81/de/adc9c918d9f94bd6ca075edd35c1d870fca4017ba6877647359306f3b362/mvn_mcp_server-2.2.2.tar.gz",
    "platform": null,
    "description": "# Maven MCP Server\n\n[![CI](https://github.com/danielscholl/mvn-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/danielscholl/mvn-mcp-server/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/danielscholl/mvn-mcp-server)](https://github.com/danielscholl/mvn-mcp-server/releases)\n[![Python](https://img.shields.io/badge/python-3.12%20|%203.13-blue)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-green)](https://modelcontextprotocol.io)\n\n**AI-powered Maven dependency management through natural language.**\n\nMaven MCP Server enables AI assistants to interact with Maven Central repository, providing comprehensive tools for version checking, security scanning, and dependency analysis\u2014all through conversational interfaces.\n\n## Why Maven MCP Server?\n\n**Traditional Maven workflow:**\n```bash\nmvn versions:display-dependency-updates  # Check all dependencies\n# Read through XML output, manually check each update\n# Manually verify security advisories\n# Repeat for each project...\n```\n\n**With Maven MCP Server:**\n```\nYou: \"Scan this project for vulnerabilities and create an update plan\"\nAI: \u2705 Found 3 critical CVEs, 12 outdated dependencies\n    \ud83d\udccb Created prioritized update plan with file locations\n    \ud83c\udfaf Ready to implement\n```\n\n> **Key Benefits:**\n> - Natural language instead of complex Maven commands\n> - Single workflow combining version checks + security + planning\n> - AI-assisted decision making with full context\n> - Intelligent caching for faster repeated queries\n> - Enterprise-ready with audit trails and traceability\n\n## Features\n\n| Category | Capabilities |\n|----------|-------------|\n| **Version Management** | Check single or batch dependency versions \u2022 Discover available updates (major/minor/patch) \u2022 List version history grouped by tracks |\n| **Security Scanning** | Integrate Trivy vulnerability scanning \u2022 CVE detection with severity filtering \u2022 Multi-module project support \u2022 Profile-based scanning for multi-cloud deployments |\n| **Enterprise Workflows** | Guided dependency triage analysis \u2022 Actionable remediation planning \u2022 Complete audit trail with CVE traceability |\n| **AI-Optimized** | Single-call comprehensive responses \u2022 Batch operations for efficiency \u2022 Intelligent caching |\n\n## Quick Start\n\n**Prerequisites:**\n\n- [Python 3.12+](https://www.python.org/downloads/)\n- [uv](https://docs.astral.sh/uv/getting-started/installation/)\n- [trivy](https://trivy.dev) (optional, for security scanning)\n- [maven](https://maven.apache.org/install.html) (optional, for profile-based scanning)\n\n\n### Setup\n\n[![Install with UV in VS Code](https://img.shields.io/badge/VS_Code-UV-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22mvn-mcp-server%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mvn-mcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)\n\n\n```bash\nmcp add mvn-mcp-server -- uvx mvn-mcp-server\n```\n\nOr add manually to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"mvn-mcp-server\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mvn-mcp-server\"]\n    }\n  }\n}\n```\n\n\n### Try It\n\n> \"Check if Spring Core 5.3.0 has any updates available\"\n\n> \"Scan my Java project for security vulnerabilities\"\n\n\n### Optional: Security Scanning\n\nInstall **Trivy** for vulnerability detection:\n\n```bash\n# macOS\nbrew install trivy\n\n# Linux\n# See: https://aquasecurity.github.io/trivy/latest/getting-started/installation/\n```\n\nWithout Trivy, version checking and dependency analysis work normally. Security scanning tools will gracefully report Trivy unavailable.\n\n**Security Note:** All processing happens locally. No source code or project data is sent to external services (except public Maven Central API queries for version information).\n\n## Available Tools\n\n| Tool | Description | Example Query |\n|------|-------------|---------------|\n| **check_version_tool** | Check single dependency version | `Check org.springframework:spring-core version 5.3.0` |\n| **check_version_batch_tool** | Check multiple dependencies | `Check these for updates: spring-core 5.3.0, junit 4.13.2` |\n| **list_available_versions_tool** | List version history by tracks | `Show all versions of commons-lang3` |\n| **scan_java_project_tool** | Security scan with Trivy | `Scan this project for vulnerabilities` |\n| **analyze_pom_file_tool** | Analyze POM file | `Analyze this pom.xml for issues` |\n\n## Available Prompts\n\n| Prompt | Description | Example Query |\n|--------|-------------|---------------|\n| **list_mcp_assets_prompt** | Show all capabilities with examples | `What can this server do?` |\n| **triage** | Complete dependency and vulnerability analysis | `Run triage for my-service` |\n| **plan** | Generate actionable remediation plan | `Create update plan for my-service` |\n\n## License\n\nThis project is licensed under the MIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n<div align=\"center\">\n\n**[Usage](https://github.com/danielscholl/mvn-mcp-server/blob/main/docs/project-usage.md)** \u2022 **[Architecture](https://github.com/danielscholl/mvn-mcp-server/blob/main/docs/project-architect.md)** \u2022 **[Contributing](https://github.com/danielscholl/mvn-mcp-server/blob/main/CONTRIBUTING.md)**\n\n</div>\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A MCP server for Maven dependency version checking",
    "version": "2.2.2",
    "project_urls": {
        "Changelog": "https://github.com/danielscholl/mvn-mcp-server/blob/main/CHANGELOG.md",
        "Documentation": "https://github.com/danielscholl/mvn-mcp-server#readme",
        "Homepage": "https://github.com/danielscholl/mvn-mcp-server",
        "Issues": "https://github.com/danielscholl/mvn-mcp-server/issues",
        "Repository": "https://github.com/danielscholl/mvn-mcp-server"
    },
    "split_keywords": [
        "mcp",
        " maven",
        " model-context-protocol",
        " dependency-management"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "887cd8a8f0e6ddca4e3790acf42b52c2d4153d5f5e1679f073ddc750f950789e",
                "md5": "27c9d3efeeb6481bf30f0f958eadb00b",
                "sha256": "d05ca39beb13bd278976bc57fee2dd22caaff25c853078a3106b5f338dd5c653"
            },
            "downloads": -1,
            "filename": "mvn_mcp_server-2.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "27c9d3efeeb6481bf30f0f958eadb00b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 97360,
            "upload_time": "2025-10-15T18:25:06",
            "upload_time_iso_8601": "2025-10-15T18:25:06.157891Z",
            "url": "https://files.pythonhosted.org/packages/88/7c/d8a8f0e6ddca4e3790acf42b52c2d4153d5f5e1679f073ddc750f950789e/mvn_mcp_server-2.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "81deadc9c918d9f94bd6ca075edd35c1d870fca4017ba6877647359306f3b362",
                "md5": "e784967560df06f0cb7d11683122f031",
                "sha256": "e2a8a8938fc0f7c8fc944270226c7623fcf724943914bb7699646fed5b6997b7"
            },
            "downloads": -1,
            "filename": "mvn_mcp_server-2.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "e784967560df06f0cb7d11683122f031",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 77867,
            "upload_time": "2025-10-15T18:25:07",
            "upload_time_iso_8601": "2025-10-15T18:25:07.681803Z",
            "url": "https://files.pythonhosted.org/packages/81/de/adc9c918d9f94bd6ca075edd35c1d870fca4017ba6877647359306f3b362/mvn_mcp_server-2.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-15 18:25:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "danielscholl",
    "github_project": "mvn-mcp-server",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mvn-mcp-server"
}
        
Elapsed time: 2.30315s