mcp-email-docker

mcp-email-docker 提供一个基于 MCP 的邮件通知服务，支持通过 SSE、Streamable HTTP 与客户端通信，并通过 SMTP 发送通知邮件。你可以通过 Docker 快速部署到本地或远程环境，利用内置的 MCP 客户端交互接口发送“邮件通知”等消息。该服务暴露了 SSE 的 /sse 连接、用于发送消息的 /messages?sessionId=xxx API，以及通过 /mcp 接口实现的 Streamable HTTP 连接，方便与其他 MCP 客户端/服务器协同工作。要使用该服务，你需要配置 SMTP 相关的环境变量（用于发送邮件）并启动容器，随后通过客户端发送通知并通过邮件接收确认。除了邮件通知，服务的 MCP 实现也可扩展以处理其他通知类型，符合 MCP 的可扩展性与流式通信设计。

Prerequisites:

• Docker 已安装并可用
• 基本的网络端口可用（示例中端口 8080）

Docker 安装与运行步骤:

1. 拉取并运行镜像 docker run -i -p 8080:8080
   --env SMTP_USER=你的邮箱账号
   --env SMTP_PASS=你的邮箱SMTP授权码
   --env SMTP_SERVICE=邮件服务提供商
   --env SMTP_HOST=smtp.example.com
   yourname/mcp-email-docker

2. 通过自定义环境变量提升安全性（可选） 将上述 --env 选项替换为 --env-file .env，其中 .env 内容示例： SMTP_USER=你的邮箱账号 SMTP_PASS=你的邮箱SMTP授权码 SMTP_SERVICE=邮件服务提供商 SMTP_HOST=smtp.example.com

3. 本地开发（可选）

   • 安装依赖并编译 ts 项目（如有源码下载） npm install npm run build
   • 使用 ts-node 直接运行入口（开发阶段） npx ts-node src/index.ts
   • 或按项目文档提供的 npm start 启动命令

4. 验证

   • 访问 http://localhost:8080/sse 以建立 SSE 连接
   • 向 /mcp 或 /messages?sessionId=xxx 发送示例消息
   • 配置 SMTP 变量后，测试发送邮件是否成功

注意事项与常见问题：

• SMTP 配置错误是常见原因，请确保 SMTP_HOST、SMTP_SERVICE 与端口正确，且 SMTP_USER/SMTP_PASS 使用正确的凭据。
• 若 Docker 部署无法访问端口，请检查防火墙设置或容器网络配置。
• 环境变量敏感信息请通过 --env-file 文件传递以提升安全性。
• 服务默认端口为 8080，如需修改，请调整 Docker 运行参数中的端口映射以及应用内监听端口。
• 如遇 TypeScript 源码变更，请参考 README 的构建步骤重新编译上线。