Nexus Email MCP Server

163电子邮件MCP服务器

用于163封电子邮件的MCP（模型上下文协议）服务器，提供通过SMTP和IMAP阅读、搜索、分析和发送电子邮件的工具。

特性

• 列出电子邮件：使用可选搜索条件列出邮箱中的电子邮件
• 获取电子邮件：获取特定电子邮件的完整内容，包括正文和附件信息
• 搜索电子邮件：使用各种条件（主题、发件人、日期、未读状态等）搜索电子邮件
• 电子邮件统计：获取邮箱统计信息（总计数、未读计数等）
• 发送邮件：发送带有附件的文本电子邮件
• 标记为已读/未读：更改电子邮件读取状态

配置

服务器使用以下配置（硬编码在 main.py):

EMAIL_ACCOUNT = "your 163 email"
SMTP_PASSWORD = "your smtp password"
SMTP_SERVER = "smtp.163.com"
SMTP_PORT = 465
IMAP_SERVER = "imap.163.com"
IMAP_PORT = 993

安装

1. 安装 紫外线 如果尚未安装。

1. 安装依赖项：

   uv sync

用法

运行服务器

uv run main.py

服务器将按照MCP协议启动并通过stdin/stdout进行通信。

可用工具

1. list_邮件

- 参数： mailbox （默认：“收件箱”）， limit （默认值：20）， search_criteria （可选IMAP标准） - 返回：电子邮件摘要列表

1. get_email

- 参数： email_id, mailbox （默认：“收件箱”） - 返回：完整的电子邮件内容，包括正文和附件信息

1. 搜索邮件

- 参数： mailbox, subject, sender, date_from, date_to, unread_only, has_attachments, limit - 返回：匹配的电子邮件摘要列表

1. get_email_统计数据

- 参数： mailbox （默认：“收件箱”）， days （默认值：30） - 返回：邮箱统计信息

1. send_邮件

- 参数： to, subject, body, cc, bcc, attachments （文件路径列表） - 返回：成功状态

1. mark_as_read

- 参数： email_id, mailbox （默认：“收件箱”） - 返回：成功状态

1. mark_as_未读

- 参数： email_id, mailbox （默认：“收件箱”） - 返回：成功状态

Claude Desktop使用示例

将服务器添加到Claude Desktop配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "163-email": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/nexus-email-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Windows附件支持

服务器支持附加常见的Windows文件格式：

• 图片：.jpg、.png、.gif、.bmp等。
• 文档：.doc、.docx、.pdf、.txt、.xlsx、.pptx等。
• 档案：.zip、.rar、.7z等。
• 视频：.mp4、.avi、.mov等。
• 任何其他文件类型都支持作为二进制附件。

安全须知

• 电子邮件凭据在源代码中是硬编码的。对于生产使用，考虑使用环境变量或配置文件。
• 服务器需要SMTP和IMAP访问您的163电子邮件帐户。
• 如果您的帐户启用了2FA，请确保您使用的是特定于应用程序的密码。

故障排除

1. 连接错误：验证您的SMTP/IMAP设置和密码。
2. 认证失败：确保您使用的是正确的SMTP授权密码（而不是您的帐户密码）。
3. 附件问题：检查文件路径是否存在以及是否可读。
4. IMAP搜索问题：某些IMAP服务器可能有特定的搜索语法要求。

许可证

MIT许可证