trackmcp
Back to directory
fantasy-lotus

mcp-email-docker

View on GitHub

基于Typescript实现的Notify MCP Server，支持Docker一键部署到remote｜local

2 stars TypeScriptServers & Infrastructure Updated Jul 17, 2025
dockeremailmcp-servertypescript

Documentation

MseeP.ai Security Assessment Badge

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打包大小

目录结构

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

快速开始

1. 安装依赖

sh
npm install

2. 配置环境变量

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

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

3. 本地开发启动

sh
npm run build
npm start

或直接用 ts-node：

sh
npx ts-node src/index.ts

Docker 部署

1. 构建镜像

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

2. 运行容器

sh
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` 文件：

sh
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`：邮件内容

依赖

License

MIT

Frequently asked questions

What is mcp-email-docker?

mcp-email-docker is 基于Typescript实现的Notify MCP Server，支持Docker一键部署到remote｜local

How do I install mcp-email-docker?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-email-docker open source?

Yes — it is hosted on GitHub at https://github.com/fantasy-lotus/mcp_email_docker and has 2 stars.

Related MCP tools

mcp-ecosystemunla

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes.

1,883 TypeScript
awesomemcpmcp-adapter+4
metatool-aimetamcp

MCP Aggregator, Orchestrator, Middleware, Gateway in one docker TypeScript-based implementation. Trusted by 1400+ developers.

1,499 TypeScript
mcpmcp-gatewaymcp-host+12
yuniko-softwareminecraft-mcp-server

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explor...

368 TypeScript
artificial-intelligenceclaudejavascript+8
ComposioHQcomposio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf

25,863 TypeScript
agentic-aiagentsai+14
microsoftplaywright-mcp

Playwright MCP server TypeScript-based implementation. Trusted by 22000+ developers. Trusted by 22000+ developers. Trusted by 22000+ developers.

22,066 TypeScript
mcpplaywright
yamadashyrepomix

📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...

19,761 TypeScript
aianthropicartificial-intelligence+17

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP