Maven MCP Server

🚀 Maven Dependency MCP Server

An MCP (Model Context Protocol) server that provides tools to check the versions of Maven dependencies. This server enables Large Language Models (LLMs) to validate Maven dependencies and fetch their latest versions from the Maven Central Repository.

🚀 Quick Start

📦 Installation

You can install this MCP server globally using npm:

npm install -g mcp-maven-deps

Or run it directly:

npx mcp-maven-deps

Installation via Smithery

To automatically install the Maven dependency server for Claude Desktop, use Smithery:

npx -y @smithery/cli install maven-deps-server --client claude

✨ Features

• Fetch the latest version of any Maven dependency.
• Validate the existence of Maven dependencies.
• Check the existence of a specific version of a dependency.
• Support full Maven coordinates, including packaging and classifier.
• Provide real-time access to Maven Central Repository data.
• Be compatible with multiple build tool formats (Maven, Gradle, SBT, Mill).

🔧 Technical Details

Development

1. Clone this repository.
2. Install dependencies: npm install.
3. Build the server: npm run build.

Configuration

Add the server to your MCP settings configuration file:

{
  "mcpServers": {
    "maven-deps-server": {
      "command": "npx",
      "args": ["mcp-maven-deps"]
    }
  }
}

If installed globally, you can also use:

{
  "mcpServers": {
    "maven-deps-server": {
      "command": "mcp-maven-deps"
    }
  }
}

💻 Usage Examples

Basic Usage

get_maven_latest_version

Get the latest version of a Maven dependency.

Input Schema:

{
  "type": "object",
  "properties": {
    "dependency": {
      "type": "string",
      "description": "Maven coordinates in the format \"groupId:artifactId[:version][:packaging][:classifier]\" (e.g., \"org.springframework:spring-core\" or \"org.springframework:spring-core:5.3.0:javadoc\")"
    }
  },
  "required": ["dependency"]
}

Example:

const result = await getMavenLatestVersion({
  dependency: 'com.example:mylib'
});

is_maven_version_valid

Validate whether a Maven dependency version is valid.

Input Schema:

{
  "type": "object",
  "properties": {
    "dependencyWithVersion": {
      "type": "string",
      "description": "Maven dependency with a version number in the format \"groupId:artifactId:version\""
    }
  },
  "required": ["dependencyWithVersion"]
}

Example:

const result = await isMavenVersionValid({
  dependencyWithVersion: 'org.springframework:spring-core:5.3.0'
});

Advanced Usage

To modify or extend the server:

1. Modify src/index.ts.
2. Rebuild using npm run build.
3. Restart the MCP server to apply the changes.

📄 License

MIT