support-and-care-labs/mail-mcp

// // Copyright 2025 The Apache Software Foundation // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //

= mail-mcp

MCP server for accessing and analyzing Apache Maven mailing list archives.

== Quick Start

=== Prerequisites

• Docker Desktop (or Podman) with Docker Compose V2

=== Setup

[source,bash]

Start all services (Elasticsearch, mail-mcp, scheduler)

docker compose up -d

Retrieve mailing list archives (first time only)

For dev@maven.apache.org:

for year in $(seq 2002 $(date +%Y)); do for month in $(seq -w 1 12); do docker compose exec scheduler retrieve-mbox --date ${year}-${month} --output-dir /app/data/dev || true done done

For users@maven.apache.org:

for year in $(seq 2002 $(date +%Y)); do for month in $(seq -w 1 12); do docker compose exec scheduler retrieve-mbox --date ${year}-${month} --list users@maven.apache.org --output-dir /app/data/users || true done done

Index all downloaded mbox files

docker compose exec scheduler index-mbox --directory /app/data/dev/ --list dev@maven.apache.org docker compose exec scheduler index-mbox --directory /app/data/users/ --list users@maven.apache.org

=== Connect MCP Client

The MCP server runs on port 58080 via Streamable HTTP transport:

[source,bash]

Claude Code

claude mcp add maven-mail --transport http http://localhost:58080/mcp

Or add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

[source,json]

{ "mcpServers": { "maven-mail": { "type": "streamable-http", "url": "http://localhost:58080/mcp" } } }

== Documentation

See xref:docs/modules/ROOT/pages/index.adoc[Documentation] for:

• Development guide and CI
• Docker setup
• MCP server configuration
• Data management
• Architecture decisions

== License

Apache License 2.0 - See xref:../LICENSE[LICENSE] for details.