Maven Repository MCP Server

What is Maven Repository MCP Server?

A Model Context Protocol server that provides comprehensive functionality to search and interact with Maven artifacts from mvnrepository.com and Maven Central. It is designed for AI assistants and developers who need to discover dependencies, retrieve versions, fetch POM files, and generate dependency snippets for Maven, Gradle, and SBT.

How to use Maven Repository MCP Server?

Install Node.js 18+, clone the repository, run npm install and npm run build. Start the server with npm start (default stdio transport) or use npm run start:sse for SSE on port 3000. Invoke tools like search_maven_artifacts, get_artifact_versions, get_pom_xml, and get_dependency_snippets via MCP client.

Key features of Maven Repository MCP Server

• Search Maven artifacts by keyword with detailed results
• Retrieve all available versions for any artifact
• Generate dependency snippets for Maven, Gradle, and SBT
• Fetch complete POM.xml files from Maven Central
• Support both stdio and SSE transport protocols
• Built-in intelligent rate limiting

Use cases of Maven Repository MCP Server

• Help users find appropriate Maven dependencies
• Assist with dependency version selection and updates
• Generate dependency blocks for different build tools
• Quickly find Maven artifacts without opening a browser
• Examine POM files and dependency structures

FAQ from Maven Repository MCP Server

What transport protocols does the server support?

The server supports stdio (default) and SSE (Server-Sent Events) protocols. Use npm run start:stdio or npm run start:sse to select.

How can I change the SSE port?

When running in SSE mode, use the --port flag, for example node dist/index.js sse --port 8080.

What rate limiting is implemented?

The server enforces a minimum of 3 seconds between requests, adds a random 2-6 second delay, and automatically retries with exponential backoff when it receives 403 errors.

What are the timeout settings?

Default request timeout is 30 seconds, Maven Central POM requests timeout after 15 seconds, and a maximum of 3 retry attempts are made for failed requests.

How do I enable debug mode?

Set the environment variable DEBUG=mvn-repository-mcp-server before starting the server, for example DEBUG=mvn-repository-mcp-server npm start.