maxtheweb/MCP-IMAP-Agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3 Commits 1 Branch 0 Tags 47 KiB
88fbde4542
Commit Graph

3 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Soldier
88fbde4542 Add production deployment for N8N with SSE transport 
Production-ready MCP IMAP server for hosted N8N workflows.

Changes:
- SSE transport using create_sse_app() for N8N compatibility
- API key authentication middleware for multi-tenant access
- Systemd service file for auto-restart on Hetzner
- Nginx reverse proxy config with TLS and rate limiting
- Complete deployment guide (DEPLOY.md)
- Removed REST API bridge (api_server.py) - N8N uses MCP protocol

Deployment:
- SSE endpoint: https://imap.maxtheweb.ai/mcp/sse
- Messages endpoint: https://imap.maxtheweb.ai/mcp/messages
- Authentication: Bearer token in Authorization header

Stack: FastMCP 2.13 + uvicorn + nginx + systemd
 2025-11-17 12:54:57 +00:00
Soldier
8232a58600 MCP IMAP server with core email tools 
Implements complete IMAP server using FastMCP protocol with 5 core tools:
- list_folders: Browse mailbox structure
- search_emails: Query with filters (sender, subject, date)
- get_email: Fetch full email content with metadata
- send_email: SMTP sending with HTML support
- health_check: Connection validation

Architecture:
- FastMCP for MCP protocol implementation
- aioimaplib for async IMAP connections
- IMAPSession class for connection pooling
- REST API bridge (api_server.py) for HTTP access

Tech: Python 3.11 + FastMCP + aioimaplib + FastAPI + aiosmtplib
 2025-11-17 12:36:09 +00:00
Soldier
3c5a9a35e8 Initial Commit 2025-11-17 09:03:53 +00:00