IMAP MCP Server
2025.04.03
4
Python电子邮件管理AI助手集成交流协作
IMAP MCP Server 是一个基于模型上下文协议（MCP）的服务，旨在为AI助手提供电子邮件管理功能。它允许AI助手检查电子邮件、处理消息，并通过交互学习用户偏好。该服务支持多种IMAP提供商，能够浏览、搜索、组织和撰写电子邮件，同时提供自动化的邮件摘要和分类功能。
View on GitHub
Overview
基本能力
产品定位
IMAP MCP Server 是一个专为AI助手设计的电子邮件管理服务，通过MCP协议与IMAP邮件服务器交互，提供智能化的邮件处理能力。
核心功能
- 电子邮件浏览与搜索：支持列出文件夹和消息，并提供过滤选项。
- 电子邮件组织：移动、标记、删除邮件等操作。
- 电子邮件撰写与回复：支持纯文本和HTML格式的回复，包括回复全部和CC功能。
- 交互式邮件处理：通过学习用户偏好，提供个性化的邮件处理建议。
- 自动化邮件摘要与分类：自动生成邮件摘要并进行分类。
- 多IMAP提供商支持：兼容多种IMAP邮件服务提供商。
适用场景
- 智能邮件助手：AI助手可以代表用户管理电子邮件，提高效率。
- 自动化邮件处理：自动分类、标记或回复常见邮件。
- 个性化邮件管理：通过学习用户偏好，提供定制化的邮件处理建议。
工具列表
- list_inbox.py：列出收件箱中的邮件。
- imap_mcp.server：启动IMAP MCP服务器。
- imap_mcp.auth_setup：管理OAuth2令牌，包括刷新和生成新令牌。
常见问题解答
- 安全性：建议使用OAuth2认证，避免直接存储密码。
- 多账户支持：当前版本暂不支持多账户，未来版本将添加此功能。
- 开发模式：使用
--dev参数启动开发模式，便于调试。
使用教程
使用依赖
- Python 3.8或更高版本
- IMAP支持的电子邮件账户（推荐Gmail）
- uv 用于包管理和运行Python脚本
安装教程
- 安装uv：
bash curl -LsSf https://astral.sh/uv/install.sh | sh - 克隆并安装包：
bash git clone https://github.com/non-dirty/imap-mcp.git cd imap-mcp uv venv source .venv/bin/activate # Windows: .venv\Scripts\activate uv pip install -e ".[dev]"
调试方式
- 列出收件箱邮件：
bash uv run list_inbox.py --config config.yaml --folder INBOX --limit 10 - 启动MCP服务器：
bash uv run imap_mcp.server --config config.yaml - 开发模式调试：
bash uv run imap_mcp.server --dev