使用说明
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
安装
-
安装 紫外线 如果尚未安装。
-
安装依赖项：
uv sync
用法
运行服务器
uv run main.py
服务器将按照MCP协议启动并通过stdin/stdout进行通信。
可用工具
-
list_邮件
- 参数：
mailbox（默认：“收件箱”），limit（默认值：20），search_criteria（可选IMAP标准） - 返回：电子邮件摘要列表
- 参数：
-
get_email
- 参数：
email_id,mailbox（默认：“收件箱”） - 返回：完整的电子邮件内容，包括正文和附件信息
- 参数：
-
搜索邮件
- 参数：
mailbox,subject,sender,date_from,date_to,unread_only,has_attachments,limit - 返回：匹配的电子邮件摘要列表
- 参数：
-
get_email_统计数据
- 参数：
mailbox（默认：“收件箱”），days（默认值：30） - 返回：邮箱统计信息
- 参数：
-
send_邮件
- 参数：
to,subject,body,cc,bcc,attachments（文件路径列表） - 返回：成功状态
- 参数：
-
mark_as_read
- 参数：
email_id,mailbox（默认：“收件箱”） - 返回：成功状态
- 参数：
-
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，请确保您使用的是特定于应用程序的密码。
故障排除
- 连接错误：验证您的SMTP/IMAP设置和密码。
- 认证失败：确保您使用的是正确的SMTP授权密码（而不是您的帐户密码）。
- 附件问题：检查文件路径是否存在以及是否可读。
- IMAP搜索问题：某些IMAP服务器可能有特定的搜索语法要求。
