Maven MCPs Documentation

Overview

This is the documentation hub for Maven MCPs, a collection of MCP (Model Context Protocol) servers designed to help with Apache Maven improvements.

These MCP servers can be used with any MCP-compatible LLM client. This documentation focuses on Claude Code as the primary client, but the MCPs work equally well with other clients such as Claude Desktop, Cursor, or any tool supporting the MCP standard.

Purpose

This collection of MCP servers provides comprehensive tooling for:

  • Analyzing Maven mailing list history and discussions

  • Supporting Maven development and maintenance workflows

  • Enabling LLM-assisted Maven improvements and contributions

  • Providing contextual information about Maven’s evolution

Available MCP Servers

Mail MCP

Search and analyze Apache Maven mailing list archives (dev@ and users@) from 2002 to present.

GitHub MCP

Access Maven GitHub repositories, issues, and pull requests.

Atlassian MCP

Access Apache Jira (legacy issues) and Confluence (wiki documentation).

See MCP Setup for installation instructions.

Getting Started

For guidance on setting up and using the complete MCP ecosystem:

See ADR-0003 for the documentation approach.

Project Structure

Each MCP server is in its own subdirectory with:

README.adoc

Project overview and quick start

docs/

Antora documentation component

docs/modules/<name>/pages/

Documentation pages

docs/modules/<name>/partials/

Reusable content fragments

src/

Source code

tests/

Test files

Documentation uses Antora for multi-component site generation. Each docs/ directory is an Antora component with a modules/ subdirectory.

Documentation Organization

Location Content

docs/modules/ROOT/pages/index.adoc

This file - main documentation hub

docs/modules/development/pages/adr/

Project-wide Architecture Decision Records

docs/modules/components/

External MCP server documentation

docs/modules/usage/

Usage and configuration guides

<project>/docs/modules/

Project-specific Antora documentation

See ADR-0001 for documentation standards.

Technology

MCP (Model Context Protocol)

Server framework for LLM tool exposure

Python 3.11+ with Poetry

Implementation language for some MCPs (e.g., Mail MCP). Other languages are possible depending on MCP requirements.

AsciiDoc with Antora

Documentation format and site generator

Contributing

When adding new MCP servers:

  1. Create a new subdirectory at the root level

  2. Follow the established project structure

  3. Set up an Antora documentation component in docs/

  4. Document architectural decisions in ADR format

  5. Update this index to list the new project

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.