Bigsy 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 to verify Maven dependencies and retrieve their latest versions from the Maven Central Repository.

✨ Features

• Query the latest version of any Maven dependency.
• Verify the existence of a specific Maven dependency.
• Check if a specific version of a dependency exists.
• Access real-time data from the Maven Central Repository.

📦 Installation

1. Clone or download 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": "node",
      "args": ["/path/to/maven-deps-server/build/index.js"]
    }
  }
}

💻 Usage Examples

Available Tools

get_maven_latest_version

Retrieve the latest version of a Maven dependency.

Input schema:

{
  "type": "object",
  "properties": {
    "dependency": {
      "type": "string",
      "description": "The Maven dependency in the format \"groupId:artifactId\" (e.g., \"org.springframework:spring-core\")"
    }
  },
  "required": ["dependency"]
}

Example usage:

const result = await mcpClient.callTool("maven-deps-server", "get_maven_latest_version", {
  dependency: "org.springframework:spring-core"
});
// Returns: "6.2.1"

check_maven_version_exists

Check if a specific version of a Maven dependency exists.

Input schema:

{
  "type": "object",
  "properties": {
    "dependency": {
      "type": "string",
      "description": "The Maven dependency in the format \"groupId:artifactId\" (e.g., \"org.springframework:spring-core\")"
    },
    "version": {
      "type": "string",
      "description": "The version to check (e.g., \"5.3.20\")"
    }
  },
  "required": ["dependency", "version"]
}

Example usage:

const result = await mcpClient.callTool("maven-deps-server", "check_maven_version_exists", {
  dependency: "org.springframework:spring-core",
  version: "5.3.20"
});
// Returns: "true" or "false"

Example Responses

Latest Version Check

// Input: org.springframework:spring-core
"6.2.1"

// Input: org.apache.kafka:kafka-clients
"3.7.2"

// Input: nonexistent.group:fake-artifact
"Maven dependency nonexistent.group:fake-artifact not found"

Version Existence Check

// Input: { dependency: "org.springframework:spring-core", version: "5.3.20" }
"true"

// Input: { dependency: "org.springframework:spring-core", version: "0.0.1" }
"false"

🔧 Technical Details

• Use the REST API of the Maven Central Repository to fetch dependency information.
• Sort the results by timestamp to ensure the latest version is returned.
• Include error handling for invalid dependencies and API issues.
• Return a clean, parsable version string for valid dependencies.
• Provide a boolean response for version existence checks.

🚫 Error Handling

The server handles various error situations:

• Invalid dependency format.
• Network connection issues.
• Failure to find dependency information.

🛠️ Development Information

To maintain or extend this server, you can refer to the following repositories and documentation:

• GitHub Repository
• Project Documentation

📄 License

[Insert license details here]