MCP Email Server

MCP Email Server

一个使用 SMTP 提供邮件发送功能的 C# Model Context Protocol（MCP）服务。

前置条件

• .NET 6.0 或更高版本
• SMTP 服务凭据（例如 Gmail、Office 365 或你自己的 SMTP 服务）

设置

1. 克隆仓库

2. 设置以下 SMTP 配置环境变量：

   • SMTP_SERVER（例如 smtp.gmail.com）
   • SMTP_PORT（例如 587）
   • SMTP_USERNAME（你的邮箱地址）
   • SMTP_PASSWORD（你的应用专用密码）

Mcp Email Server 可以使用以下命令运行：

 "mcp-email-server": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", 
              "--project",
              "YOUR_PATH/smtp-dotnet-mcp-server/McpEmailServer.csproj"
            ],
      "env": {       
        "SMTP_SERVER": "localhost",
        "SMTP_PORT": "25",
        "SMTP_USERNAME": "",
        "SMTP_PASSWORD": ""
      }
    }

或者

 "mcp-email-server": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c",               
              "YOUR_PATH/smtp-dotnet-mcp-server/McpEmailServer.exe"
            ],
      "env": {       
        "SMTP_SERVER": "localhost",
        "SMTP_PORT": "25",
        "SMTP_USERNAME": "",
        "SMTP_PASSWORD": ""
      }
    }

Gmail 设置（如果使用 Gmail）

如果你使用 Gmail，需要：

1. 在 Google 账号中启用两步验证
2. 生成应用专用密码：
   • 前往 Google 账号设置
   • 安全性
   • 两步验证
   • 应用专用密码
   • 为“Mail”生成新的应用专用密码

运行服务

dotnet run

可用工具

该服务提供以下 MCP 工具：

1. SendEmail：发送纯文本邮件

   • 参数：
     • to：收件人邮箱地址
     • subject：邮件主题
     • body：邮件正文

2. SendHtmlEmail：发送 HTML 邮件

   • 参数：
     • to：收件人邮箱地址
     • subject：邮件主题
     • htmlBody：邮件正文的 HTML 内容

功能

• 使用 stdio 传输的 MCP 服务实现
• SMTP 邮件发送功能
• 支持纯文本和 HTML 邮件
• 为 SMTP 客户端和设置提供依赖注入
• 可通过 appsettings.json 配置
• 完善的错误处理和日志记录

安全须知

• 切勿将邮箱凭据提交到源代码管理中
• 应将 appsettings.json 文件添加到 .gitignore
• 尽可能使用应用专用密码，而非主密码
• 在生产环境中，考虑使用环境变量或安全的配置管理系统