MCP 邮件服务器

概述

这是一个基于 Model Context Protocol (MCP) 的邮件发送服务器，集成到 Cursor AI 编辑器中，允许通过自然语言指令发送邮件。

功能特性

• 通过 Cursor AI 自然语言发送邮件
• 支持 WP 邮箱 SMTP 服务
• 自动处理邮件格式和编码
• 集成到 Cursor 的 MCP 工具系统

系统要求

• Node.js >= 16.0.0
• Cursor 编辑器
• 有效的 WP 邮箱账户

安装配置

Cursor MCP 集成

1. 配置文件位置

编辑 Cursor 的 MCP 配置文件：

/PATH/mcp.json

2. 添加邮件服务器配置

在 mcp.json 文件中添加以下配置：

{
  "mcpServers": {
    "cursor-email-online": {
      "timeout": 60,
      "command": "npx -y cursor-email-chris",
      "args": [],
      "env": {
        "EMAIL_USER": "your user",
        "EMAIL_PASSWORD": "your password"
      },
      "type": "stdio"
    }
  }
}

3. 重启 Cursor

配置完成后，重启 Cursor 编辑器以加载 MCP 服务器。

4. 验证集成

重启后，在 Cursor 中应该能看到 mcp_cursor-email_send_email 工具可用。

使用方法

通过 Cursor AI 发送邮件

在 Cursor 编辑器中，直接使用自然语言指令：

发送邮件给 recipient@example.com，主题是 "邮件主题"，内容是 "邮件内容"

技术架构

核心组件

• email-server.js - MCP 服务器主程序
• email-config.env - 环境变量配置

MCP 工具

• send_email - 邮件发送工具
• 支持参数：收件人、主题、正文、抄送、密送

故障排除

常见问题

1. MCP 工具不可用

   • 重启 Cursor 编辑器
   • 检查 MCP 配置文件路径和格式
   • 确认 mcp.json 文件语法正确

2. MCP 服务器启动失败

   • 检查 email-server.js 文件路径是否正确
   • 验证 Node.js 版本 >= 16.0.0
   • 确认依赖包已安装：npm install

3. 邮件发送失败

   • 验证收件人邮箱地址格式
   • 检查网络连接状态
   • 确认 SMTP 服务器可用性
   • 验证邮箱认证信息

4. 环境变量问题

   • 检查 mcp.json 中的环境变量设置
   • 确认 EMAIL_USER 和 EMAIL_PASSWORD 正确

错误代码

• ESOCKET - 网络连接错误
• EAUTH - 认证失败
• MODULE_NOT_FOUND - 模块加载错误

安全注意事项

• 邮箱密码存储在环境变量中
• 建议定期更换密码
• 不要在代码中硬编码敏感信息

开发说明

文件结构

cursor-email-mcp/
├── email-server.js          # MCP 服务器主程序
├── email-config.env         # 环境变量配置（可选）
├── package.json             # 项目依赖
├── package-lock.json        # 依赖锁定文件
├── node_modules/            # 依赖包目录
└── README.md               # 说明文档

MCP 集成原理

1. MCP 协议 - 使用 Model Context Protocol 与 Cursor 通信
2. 工具注册 - 通过 ListToolsRequestSchema 注册邮件发送工具
3. 请求处理 - 使用 CallToolRequestSchema 处理邮件发送请求
4. 环境变量 - 通过 Cursor 的 MCP 配置传递认证信息

依赖包

• @modelcontextprotocol/sdk - MCP 协议支持
• nodemailer - 邮件发送库

配置说明

• MCP 服务器名称: cursor-email
• 工具名称: send_email
• 环境变量: 通过 mcp.json 传递

版本信息

• 当前版本: 1.0.0
• 最后更新: 2024年
• 兼容性: Cursor AI, Node.js 16+

技术支持

如遇问题，请检查：

1. 网络连接状态
2. SMTP 服务器可用性
3. 邮箱认证信息
4. Cursor MCP 配置

注意: 请勿修改核心配置文件，以免影响系统正常运行。