What is Mcp Email Docker

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

Use cases

Use cases for mcp-email-docker include sending automated email notifications for user actions, real-time updates for web applications, and integrating with other services that require email communication through the MCP protocol.

How to use

To use mcp-email-docker, first install the dependencies using ‘npm install’. Then, configure the environment variables in a ‘.env’ file. For local development, build the project with ‘npm run build’ and start it with ‘npm start’. For Docker deployment, build the image with ‘docker build -t yourname/mcp-email-docker .’ and run the container with 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 to remote or local environments. The Dockerfile employs 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 email notifications, such as web applications, notification systems, and any service that needs to communicate with clients in real-time.

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