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

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