Mail MCP - 邮件发送MCP

Mail MCP 提供了一个可以通过 AI
工具调用的邮件发送功能，允许 AI 系统发送 HTML 或纯文本邮件。

下载

git clone https://github.com/falst-zi/Mcp-Java.git

功能特性

• 通过 MCP 协议提供邮件发送工具
• 支持发送 HTML 格式和纯文本格式的邮件
• 可配置的邮件服务器参数
• 支持环境变量配置邮件认证信息

环境要求

• Java 17 或更高版本

快速开始

1. 托管部署

在运行应用之前，需要配置以下环境变量：

MAIL_HOST=smtp.qq.com     # 邮件服务器主机
MAIL_PORT=587             # 邮件服务器端口
MAIL_NAME=your-email@qq.com   # 发送者邮箱地址
MAIL_PASSWORD=your-password   # 邮箱授权码（不是登录密码）

配置说明

应用的主要配置在 application.yml 文件中：

server:
  port: 9000
# Using spring-ai-starter-mcp-server-webmvc
spring:
  ai:
    mcp:
      server:
        stdio: false # 禁用标准输入输出通信方式
        name: email-webmvc-server # MCP服务器名称
        version: 1.0.0 # MCP服务器版本
        type: SYNC # 服务器类型，SYNC表示同步模式
        instructions: "这个服务器提供邮件发送的工具和资源" # 服务器功能说明
        sse-message-endpoint: /mcp/messages # 服务端消息推送端点
        capabilities:
          tool: true
          resource: true
          prompt: true
          completion: true

2. 构建项目

./mvnw clean package

3. 运行应用

java -jar target/mail-mcp-0.0.1-SNAPSHOT.jar

或者直接使用 Maven 运行：

./mvnw spring-boot:run

使用方式

{
  "mcpServers": {
    "email-mcp-server": {
      "type": "sse",
      "url": "http://xxx:9000/sse"
    }
  }
}

2. 本地部署

配置说明

应用的主要配置在 application.yml 文件中：

spring:
  main:
    banner-mode: off # 表示关闭 Spring Boot 启动时的横幅显示。保持控制台输出简洁
    web-application-type: none # none 启动方式 不启动web容器
  ai:
    mcp:
      server:
        stdio: true # 启用标准输入输出通信方式
        name: email-webmvc-server # MCP服务器名称
        version: 1.0.0 # MCP服务器版本
        type: SYNC # 服务器类型，SYNC表示同步模式
        instructions: "这个服务器提供邮件发送的工具和资源" # 服务器功能说明
        sse-message-endpoint: /mcp/messages # 服务端消息推送端点
        capabilities:
          tool: true
          resource: true
          prompt: true
          completion: true

2. 构建项目

./mvnw clean package

3. 使用方式

{
  "mcpServers": {
    "email-mcp-server": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dlogging.pattern.console=",
        "-jar",
        "C:\\xxx\\mail-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "MAIL_HOST": "xxx",
        "MAIL_NAME": "xxx",
        "MAIL_PASSWORD": "xxx"
      }
    }
  }
}

提供工具

应用启动后，将通过 MCP 协议提供一个sendEmail邮件发送工具，该工具具有以下参数：

• email: 接收者邮箱地址
• subject: 邮件主题
• content: 邮件内容
• isHtml: 是否为 HTML 邮件（true/false）

HTML 邮件注意事项

发送 HTML 邮件时，请注意以下几点以确保兼容性：

1. 使用内联 CSS 样式而不是外部样式表
2. 使用传统的表格布局而不是现代 CSS 布局
3. 避免使用 JavaScript
4. 图片使用绝对 URL 并指定宽高属性

示例 HTML 邮件内容：

<div style="padding: 20px; background-color: #f5f5f5;">
  <h2 style="color: #333;">邮件标题</h2>
  <p style="font-size: 16px; color: #666;">这是一封HTML邮件示例</p>
</div>

安全提示

1. 邮箱密码应使用授权码而非登录密码
2. 敏感配置信息通过环境变量注入，不要硬编码在配置文件中
3. 在生产环境中限制对 MCP 端点的访问