163邮箱 MCP 服务器

这是一个基于Gradio的163邮箱MCP服务器，可以作为LLM的工具，用于获取和处理电子邮件。

功能

获取最新的未读邮件
检查指定类型和数量的邮件
保存邮件附件
发送纯文本邮件
发送HTML格式邮件
发送带附件的邮件

安装依赖

使用requirements.txt安装

pip install -r requirements.txt

手动安装

pip install gradio[mcp] bs4 python-dotenv

启动服务器

直接启动

python email_mcp_server.py

使用环境变量启动

可以通过环境变量来配置邮箱账号信息：

chmod +x start_with_env.sh ./start_with_env.sh

或者手动设置环境变量：

export EMAIL_IMAP_SERVER=imap.163.com export EMAIL_SMTP_SERVER=smtp.163.com export EMAIL_ACCOUNT=your_email@163.com export EMAIL_PASSWORD=your_password python email_mcp_server.py

MCP工具

服务器提供以下MCP工具：

get_newest_email - 获取最新的未读邮件（可选覆盖参数：imap_server、account、password）
check_emails - 检查指定类型和数量的邮件（可选覆盖参数：imap_server、account、password）
save_attachment - 保存指定的附件（可选覆盖参数：imap_server、account、password）
send_text_email - 发送纯文本邮件（可选覆盖参数：smtp_server、account、password）
send_html_email - 发送HTML格式邮件（可选覆盖参数：smtp_server、account、password）
send_email_with_attachment - 发送带附件的邮件（可选覆盖参数：smtp_server、account、password）

发送示例：自定义发送者账号

curl -X POST http://localhost:7860/gradio_api/mcp/run/send_text_email \ -H "Content-Type: application/json" \ -d '{ "to_addr": "someone@example.com", "subject": "自定义发件人测试", "content": "这是一封从自定义发件人发送的测试邮件", "account": "your_email@163.com", "password": "your_app_password", "smtp_server": "smtp.163.com" }'

读取示例：自定义接收账号

curl -X POST http://localhost:7860/gradio_api/mcp/run/get_newest_email \ -H "Content-Type: application/json" \ -d '{ "account": "your_email@163.com", "password": "your_app_password", "imap_server": "imap.163.com" }'