Emailservice

by MrHZ006

332 downloads
Not rated
GitHub

About

An email MCP(Server) service based on Spring Boot, used for sending emails via QQ SMTP and exposing utility functions in the form of Spring AI MCP Server It is convenient to call in clients that support MCP (such as ides/Agents that support MCP, etc.).

Details

Author
MrHZ006
Downloads
332
Categories
Other

- Built on Spring Boot for easy deployment and integration
- Sends emails via QQ Mail’s SMTP service
- Requires a dedicated SMTP authorization code (not the QQ login password)
- Configurable as an MCP server with stdio transport
- Includes security guidance for handling credentials

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Emailservice
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Download or clone the project, package it as a JAR file using Maven or Gradle, and place the resulting Email-service-0.0.1-SNAPSHOT.jar in your project root. Obtain a 16‑character SMTP authorization code from QQ Mail’s settings, then configure the MCP server with the --qq.username and --qq.password arguments.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "emailservice": {
            "Email-service": {
                "command": "java",
                "args": [
                    "-Dspring.ai.mcp.server.stdio=true",
                    "-Dspring.main.web-application-type=none",
                    "-Dlogging.pattern.console=",
                    "-jar",
                    "Email-service-0.0.1-SNAPSHOT.jar",
                    "--qq.username=Your email address",
                    "--qq.password=Your email address credentials"
                ],
                "env": []
            }
        }
    }
}

McpServers

{
    "Email-service": {
        "command": "java",
        "args": [
            "-Dspring.ai.mcp.server.stdio=true",
            "-Dspring.main.web-application-type=none",
            "-Dlogging.pattern.console=",
            "-jar",
            "Email-service-0.0.1-SNAPSHOT.jar",
            "--qq.username=Your email address",
            "--qq.password=Your email address credentials"
        ],
        "env": []
    }
}

工具简介
这是一个基于Spring Boot开发的QQ邮箱服务工具,提供了便捷的邮件发送功能。通过简单的配置,您可以快速集成QQ邮箱的SMTP服务,实现自动化的邮件发送能力。
🚀 快速开始
1. 下载项目
首先下载或克隆邮件服务项目到本地环境。

2. 打包JAR文件
使用Maven或Gradle将项目打包成可执行的JAR文件:

Maven方式


mvn clean package

Gradle方式


gradle build

打包完成后,会在target目录下生成 Email-service-0.0.1-SNAPSHOT.jar 文件。
3. 放置JAR文件
将打包好的 Email-service-0.0.1-SNAPSHOT.jar 文件放置到源项目的根目录下。

4. 配置QQ邮箱信息
获取SMTP授权码
登录QQ邮箱网页版

进入【设置】→【账户】

找到【POP3/IMAP/SMTP服务】 section

开启【POP3/SMTP服务】或【IMAP/SMTP服务】

根据提示获取16位SMTP授权码(注意:这不是QQ密码!)

修改启动配置
在您的MCP服务器配置中,更新以下两个关键参数:
{
"mcpServers": {
"Email-service": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-Dspring.main.web-application-type=none",
"-Dlogging.pattern.console=",
"-jar",
"Email-service-0.0.1-SNAPSHOT.jar",
"--qq.username=你的QQ邮箱地址",
"--qq.password=你的SMTP授权码"
],
"env": {}
}
}
}
⚙️ 配置说明
--qq.username: 填写完整的QQ邮箱地址(如:992382472@qq.com)

--qq.password: 填写从QQ邮箱获取的SMTP授权码(16位字符串)

🔒 安全提醒
⚠️ 重要安全注意事项:

切勿使用QQ登录密码:必须使用专门的SMTP授权码

保护授权码:授权码具有与密码同等的权限,请妥善保管

定期更换:建议定期更新SMTP授权码以增强安全性

环境隔离:生产环境建议使用环境变量或配置文件管理敏感信息

📋 验证配置
配置完成后,启动服务并检查:

服务是否正常启动

邮箱连接是否成功建立

测试邮件发送功能是否正常工作

🆘 常见问题
Q: 为什么连接失败?
A: 请检查:

邮箱地址格式是否正确

SMTP授权码是否准确(注意区分大小写)

是否已开启SMTP服务

Q: 授权码在哪里获取?
A: 必须通过QQ邮箱网页版的【设置】→【账户】→【POP3/IMAP/SMTP服务】中开启并获取。

如有其他问题,请参考项目文档或联系技术支持-992382472@qq.com。

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.