IMAP MCP Server

基本能力

产品定位

IMAP MCP Server 是一个专注于电子邮件管理和 AI 分析的中间件服务，旨在为 AI 助手提供强大的电子邮件交互能力。

核心功能

1. IMAP 电子邮件访问：支持标准的 IMAP 操作，如连接服务器、列出文件夹、读取邮件等。
2. AI 邮件分析：利用 Gemini AI 提取邮件中的结构化数据，如会议信息、任务项等。
3. 高级邮件管理：包括邮件标记、移动、创建文件夹、查找重复邮件等功能。
4. 智能整理建议：AI 驱动的收件箱清理建议，识别旧邮件、重复邮件或低优先级邮件。
5. 错误处理和安全性：全面的错误处理机制和安全考虑，确保数据安全。

适用场景

1. AI 助手集成：为 AI 助手提供电子邮件交互能力。
2. 电子邮件自动化：自动化邮件分类、标记和整理。
3. 数据提取：从邮件中提取结构化数据，如会议信息、任务项等。
4. 收件箱管理：智能整理收件箱，提高工作效率。

工具列表

1. connect_imap：建立与 IMAP 服务器的连接。
2. list_folders：列出所有可用的邮件文件夹。
3. list_messages：列出指定文件夹中的邮件及其元数据。
4. read_message：读取邮件的完整内容，包括正文和附件。
5. search_messages：使用 IMAP 搜索条件搜索邮件。
6. move_messages：将邮件从一个文件夹移动到另一个文件夹。
7. create_folder：在 IMAP 邮箱中创建新文件夹。
8. mark_flagged：标记或取消标记邮件以便跟进。
9. mark_read：将邮件标记为已读或未读。
10. analyze_email：使用 Gemini AI 从邮件中提取结构化数据。

常见问题解答

1. 连接问题：检查 IMAP 服务器地址和端口，确保凭据正确。
2. 认证错误：验证用户名和密码，检查 2FA 要求。
3. AI 分析问题：确认 Gemini API 密钥有效，检查 API 配额和限制。

使用教程

使用依赖

1. 创建并激活 Python 虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖：

pip install -r requirements.txt

安装教程

1. 在根目录创建 .env 文件：

IMAP_SERVER="imap.gmail.com"
IMAP_USERNAME="[email protected]"
IMAP_PASSWORD="your-app-specific-password"
GOOGLE_API_KEY="your-gemini-api-key"

1. 运行服务器：

python src/server.py

调试方式

1. 在 VS Code 中启动服务器：
2. 打开命令面板（Cmd/Ctrl + Shift + P）
3. 输入 "MCP: Connect to Server"

4. 选择 "imap-mcp"

5. 验证连接：

6. 检查 VS Code 状态栏中的 MCP 连接状态

7. 服务器日志输出将在 VS Code 输出面板中可见

8. 测试连接：

9. 使用 connect_imap 工具建立连接
10. 尝试 list_folders 验证 IMAP 访问是否正常工作
11. 使用简单模式测试邮件分析功能

许可证

该项目遵循 MIT 开源许可条款。