MCP Mail Server

🚀 MCP邮件服务器

MCP邮件服务器是一个用于IMAP/SMTP邮件操作的模型上下文协议服务器，可与Claude、Cursor等AI助手协同工作，帮助用户更便捷地管理和操作邮件。

🚀 快速开始

1. 安装：使用命令 npm install -g mcp-mail-server 进行全局安装。
2. 配置：配置环境变量（详见 配置说明）。
3. 添加：将其添加到你的MCP客户端配置中。
4. 使用：通过自然语言指令操作，例如 "Show me unread emails from today"。

✨ 主要特性

• IMAP操作：可在多个邮箱中搜索、读取和管理邮件。
• SMTP支持：支持发送包含HTML或纯文本内容以及附件的邮件。
• 安全配置：基于环境变量进行设置，支持TLS/SSL加密。
• AI友好：支持使用自然语言命令进行邮件操作。
• 自动连接管理：自动处理IMAP和SMTP连接。
• 多邮箱支持：可访问收件箱、已发送邮件和自定义文件夹。

📦 安装指南

Claude桌面版

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

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASS": "your-password"
      }
    }
  }
}

Cursor

在Cursor的MCP设置中添加以下配置：

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASS": "your-password"
      }
    }
  }
}

其他MCP客户端

进行全局安装：

npm install -g mcp-mail-server

然后进行如下配置：

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "mcp-mail-server"
    }
  }
}

📚 详细文档

可用工具

💻 使用示例

基础用法

可以通过向AI助手输入自然语言命令来操作邮件，例如：

• "Connect to my email servers"
• "Show me all unread emails"
• "Search for emails from boss@company.com"
• "Send an email to team@company.com about the meeting"
• "Reply to email with UID 123"

高级用法

• "Find emails with 'urgent' in the subject from last week"
• "Show me unreplied emails from boss@company.com"
• "Show me large emails over 5MB"
• "Get all emails from the Sales folder"

邮件管理

• "Delete the email with UID 123"
• "Mark recent emails as read"
• "List all my email folders"

🔧 技术细节

配置环境变量

⚠️ 重要提示

所有环境变量均为必填项。

常见邮箱提供商配置

安全注意事项

⚠️ 重要提示

• 建议启用2FA并使用应用专用密码。
• 始终使用安全连接（IMAP_SECURE=true，SMTP_SECURE=true）。
• 切勿在配置文件中硬编码凭证信息。

本地开发设置

1. 克隆仓库：

git clone https://github.com/yunfeizhu/mcp-mail-server.git
cd mcp-mail-server

2. 安装依赖：

npm install

3. 构建项目：

npm run build

4. 设置环境变量：

export IMAP_HOST=your-imap-server.com
export IMAP_PORT=993
export IMAP_SECURE=true
export SMTP_HOST=your-smtp-server.com
export SMTP_PORT=465
export SMTP_SECURE=true
export EMAIL_USER=your-email@domain.com
export EMAIL_PASS=your-password

5. 启动服务器：

npm start

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

包信息：

• 包名：mcp-mail-server
• Node.js版本：≥18.0.0
• 仓库地址：GitHub
• 问题反馈：报告问题