MCP Server Setup and Usage

docker compose up -d

# Retrieve dev@ archives (July 2002-present, ~750MB)
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

# Retrieve users@ archives (Nov 2002-present, ~800MB)
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

# Check services are running
docker compose ps

# Check mail-mcp health
curl http://localhost:58080/health

# Check Elasticsearch has data
curl http://localhost:59200/maven-dev/_count
curl http://localhost:59200/maven-users/_count

# Elasticsearch connection
MAIL_MCP_ELASTICSEARCH_URL=http://localhost:59200
MAIL_MCP_ELASTICSEARCH_INDEX_PREFIX=maven

# Archive URL resolution (default: true)
# When enabled, automatically looks up Pony Mail permalink IDs
# for messages and caches them in Elasticsearch
MAIL_MCP_RESOLVE_ARCHIVE_URLS=true

# Logging
MAIL_MCP_LOG_LEVEL=INFO

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

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

"Search for emails about Maven 4.0 release"
"Find discussions about dependency resolution from 2024"
"Show votes about the build cache feature"

"Show me the email with ID <abc123@example.com>"

"Get the full thread for message <abc123@example.com>"
"Show me the discussion thread about MNG-1234"

"Find all discussions about MNG-1234"
"Show emails mentioning GitHub PR #567"

"What were the main discussions about Maven 4.0 in 2024?"
"Find recent decisions about the build cache"
"Show me emails where people voted on the wrapper feature"
"Search for discussions about dependency resolution performance"

"What's the status of MNG-1234?"
"Show all discussions about MRESOLVER-567"
"Find emails related to GitHub PR #123"

"Show me the full discussion thread about the Maven 4 release"
"Get the conversation that led to the decision on feature X"

# Check service status
docker compose ps

# Check mail-mcp logs
docker compose logs mail-mcp

# Check health endpoint
curl http://localhost:58080/health