What is Mcp Email Docker

mcp_email_docker is a Notify MCP Server implemented in TypeScript, designed to facilitate email notifications through the Model Context Protocol (MCP). It supports communication with clients via Streamable HTTP and Server-Sent Events (SSE), and can send notification emails using SMTP services. The project is also suitable for beginners to learn about MCP Server.

Use cases

Use cases for mcp_email_docker include sending automated emails for user registrations, notifications for system alerts, and real-time updates for applications using SSE or Streamable HTTP protocols.

How to use

To use mcp_email_docker, first install the dependencies with ‘npm install’. Configure the environment variables in a ‘.env’ file. For local development, build the project using ‘npm run build’ and start it with ‘npm start’. Alternatively, you can run it directly using ‘npx ts-node src/index.ts’. For Docker deployment, build the image with ‘docker build -t yourname/mcp-email-docker .’ and run the container with the appropriate environment variables.

Key features

Key features of mcp_email_docker include support for MCP clients to send emails or notifications, compatibility with both old SSE and new Streamable HTTP protocols, and one-click Docker deployment for remote or local environments. The Dockerfile uses multi-stage builds and a slim Node.js environment to reduce image size.

Where to use

mcp_email_docker can be used in various fields that require notification services, such as web applications, automated systems, or any platform needing email notifications through a reliable and scalable server.

mcp-email-docker

基于 Model Context Protocol (MCP) 的邮件通知服务，支持通过Streamable HTTP， SSE（Server-Sent Events）与客户端通信，并通过 SMTP 服务发送通知邮件。已支持 Docker 镜像部署。
本项目也适合作为新手上手学习MCP Server的学习项目

功能特性

• 支持接入MCP Client通过 MCP 协议发送邮件或其他通知
• ⭐️ 兼容旧SSE和新Streamable HTTP协议
• ⭐️ 支持 Docker 一键部署到remote or local，通过Http而不是Stdio通信
  • Dockerfile使用多阶段构建以及slim nodejs环境降低image打包大小

目录结构

.
├── package.json        # 项目依赖与脚本
├── Dockerfile          # Docker 镜像构建文件
├──.dockerignore        # Docker build忽略设置
├── tsconfig.json       # TypeScript 配置
├── src/
│   ├── index.ts        # 服务器入口
│   ├── mcp/
│   │   └── notify.ts   # MCP 通知服务实现
│   └── tool/
│       └── notify.ts   # 邮件发送工具
└── .env.example        # 环境变量示例

快速开始

1. 安装依赖

npm install

2. 配置环境变量

在项目根目录下创建 .env 文件，内容示例：

SMTP_USER=你的邮箱账号
SMTP_PASS=你的邮箱SMTP授权码
SMTP_SERVICE=
SMTP_HOST
PORT=

3. 本地开发启动

npm run build
npm start

或直接用 ts-node：

npx ts-node src/index.ts

Docker 部署

1. 构建镜像

docker build -t yourname/mcp-email-docker .

2. 运行容器

docker run -p 8080:8080 \
  -e SMTP_USER=你的邮箱账号 \
  -e SMTP_PASS=你的邮箱SMTP授权码 \
  -e SMTP_SERVICE=QQ \
  -e SMTP_HOST=smtp.qq.com \
  yourname/mcp-email-docker

或使用 .env 文件：

docker run --env-file .env -p 8080:8080 yourname/mcp-email-docker

API 说明

• GET /sse
  建立 SSE 连接，用于实时消息推送。

• POST /messages?sessionId=xxx
  客户端发送消息接口，需携带 sessionId。

• POST /mcp
  通过 Streamable HTTP协议连接mcp server

MCP 邮件通知参数

• method：通知方式，目前仅基于nodemailer实现 "email"
• to：收件人邮箱
• content：邮件内容

依赖

• @modelcontextprotocol/sdk
• nodemailer
• zod
• dotenv
• express

License

MIT