mcp-email-docker

What is mCP-email-docker?

It is an MCP server that provides email notification functionality. It communicates with MCP clients via Streamable HTTP or SSE and sends notification emails through SMTP. The server is designed for Docker deployment and also serves as a learning project for MCP server development.

How to use mCP-email-docker?

Install dependencies with npm install, configure environment variables (SMTP_USER, SMTP_PASS, SMTP_SERVICE, SMTP_HOST, PORT) in a .env file, then build and start with npm run build && npm start. For Docker, build the image with docker build -t yourname/mcp-email-docker . and run with docker run -p 8080:8080 --env-file .env yourname/mcp-email-docker.

Key features of mCP-email-docker

• MCP client integration for email notifications.
• Supports both SSE and Streamable HTTP transports.
• One‑click Docker deployment to remote or local.
• Docker image uses multi‑stage build for smaller size.
• Environment variable configuration via .env file.
• Email sending via SMTP using nodemailer.

Use cases of mCP-email-docker

• Send email notifications from MCP‑powered applications.
• Use as a learning project for MCP server implementation.
• Deploy a notification service via Docker for quick setup.
• Integrate with existing MCP clients for automated alerts.

FAQ from mCP-email-docker

What dependencies does mCP-email-docker use?

It uses @modelcontextprotocol/sdk, nodemailer, zod, dotenv, and express.

How do I start the server locally?

Build with npm run build then start with npm start, or run directly with npx ts-node src/index.ts.

How do I deploy with Docker?

Build the image with docker build -t yourname/mcp-email-docker . and run with environment variables or a .env file, e.g., docker run -p 8080:8080 --env-file .env yourname/mcp-email-docker.

What environment variables are required?

SMTP_USER, SMTP_PASS, SMTP_SERVICE, SMTP_HOST, and PORT (default 8080).

What API endpoints does the server expose?

GET /sse for SSE connection, POST /messages?sessionId=xxx for sending messages, and POST /mcp for Streamable HTTP connection.