mail-mcp Documentation

Overview

mail-mcp is an MCP (Model Context Protocol) server for accessing and analyzing Apache Maven mailing list archives. It provides tools to retrieve and process historical email discussions from Maven mailing lists, primarily dev@maven.apache.org.

Status

Functional - MCP server implemented with Streamable HTTP transport on port 58080. All core tools (search, get_message, get_thread, find_references) available.

Quick Start

See the project README for prerequisites and initial setup.

Documentation

Getting Started

Development Guide

Development workflow, project structure, virtual environment setup, and CI.

Docker Setup

Running Elasticsearch and related services with Docker Compose.

Using the MCP Server

MCP Server Guide

Setting up and using the MCP server with Claude Code and Claude Desktop.

Data Management

Working with mbox files, downloading archives, and indexing.

Analysis and Testing

Analysis Scripts

Scripts for analyzing and exploring the email archives.

Testing MCP

Testing the MCP server implementation.

Project Status

Roadmap

Implementation status and planned features.

Architecture Decisions

Architecture Decision Records document key technical decisions:

ADR Title Status

ADR-0001

Storage and Access Strategy (Elasticsearch)

Accepted

ADR-0002

Technology Stack (Python 3.11+)

Accepted

ADR-0003

Archive URL Resolution (Pony Mail)

Accepted

ADR-0004

Lenient mypy Configuration for MVP

Accepted

Part of Maven MCPs

This project is one MCP server within the maven-mcps umbrella project.