微信扫一扫article
README
🚀 电子邮件处理 MCP 服务器
本 MCP 服务器专注于电子邮件处理，集成了 MongoDB 进行语义搜索，同时采用 SQLite 实现高效的存储与检索功能，为用户提供了强大且稳定的电子邮件处理解决方案。
✨ 主要特性
现有功能
- 支持处理带有日期范围过滤的 Outlook 电子邮件，方便用户筛选特定时间段内的邮件。
- 可在 SQLite 数据库中存储电子邮件，并进行适当的连接管理，确保数据的稳定存储。
- 借助 Ollama 生成向量嵌入，为语义搜索提供支持。
- 支持多邮箱，满足不同用户的多样化需求。
- 支持 Inbox、Sent Items 和可选的 Deleted Items 文件夹，覆盖常见的邮件使用场景。
待实现功能
- 带有语义能力的电子邮件搜索，提升搜索的准确性和效率。
- 使用 LLM 的电子邮件摘要，帮助用户快速了解邮件内容。
- 自动电子邮件分类，实现邮件的智能整理。
- 可自定义的电子邮件报告，满足个性化的数据分析需求。
- 高级过滤选项，提供更精细的邮件筛选方式。
- Outlook 草拟电子邮件响应，节省用户的回复时间。
- Outlook 规则建议，优化邮件管理流程。
- 扩展数据库选项，集成 Neo4j 和 ChromaDB，增强数据存储和处理能力。
📦 安装指南
先决条件
- 需安装 Python 3.10 或更高版本。
- Ollama 需在本地运行，用于生成嵌入。
- 需安装 Microsoft Outlook。
- 操作系统需为 Windows，以实现 Outlook 集成。
- 需运行 MongoDB 服务器，用于存储嵌入。
安装步骤
- 安装 uv（如果尚未安装）：
pip install uv - 创建虚拟环境：
uv venv .venv - 激活虚拟环境：
- Windows：
.venv\Scripts\activate- macOS/Linux：
source .venv/bin/activate - 安装依赖项：
uv pip install -e .
- 安装 fastmcp 包：
uv pip install fastmcp
- 确保 Ollama 本地运行并安装所需模型：
ollama pull nomic-embed-text
📚 详细文档
配置
将服务器添加到您的 Claude for Desktop 配置文件中：
- Windows：%APPDATA%\Claude\claude_desktop_config.json
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"outlook-email": {
"command": "C:/Users/username/path/to/mcp-server-outlook-email/.venv/Scripts/python",
"args": [
"C:/Users/username/path/to/mcp-server-outlook-email/src/mcp_server.py"
],
"env": {
"MONGODB_URI": "mongodb://localhost:27017/MCP?authSource=admin",
"SQLITE_DB_PATH": "email_processing.db",
"OLLAMA_HOST": "localhost",
"OLLAMA_PORT": 11434
}
}
}
}
示例用法在 Claude 中
"Process emails from February 1st to February 17th from all mailboxes"
架构
服务器采用混合搜索方法：
- SQLite 数据库用于：
- 主电子邮件存储
- 全文搜索功能
- 处理状态跟踪
- 高效过滤
- 目录自动创建（如果不存在）
- 连接在服务器关闭时正确关闭，以防止“无法操作已关闭数据库”错误
- MongoDB 用于：
- 嵌入式向量存储
- 语义相似性搜索
- 元数据过滤
- 高效检索
- 在服务器关闭后正确关闭连接
错误处理
服务器提供详细错误消息，针对常见问题：
- 无效日期格式
- 与 Outlook 的连接问题
- MongoDB 错误
- 嵌入式生成失败并带有重试逻辑
- SQLite 存储错误
- Ollama 服务器连接问题的自动重试
资源管理
服务器实现适当的资源管理以防止问题：
- 数据库连接（SQLite 和 MongoDB）在服务器生命周期内保持打开状态，以防止“无法操作已关闭数据库”错误
- 连接仅在服务器关闭时关闭，使用 atexit 处理器
- 使用破坏性和上下文管理器作为最后手段，确保连接在对象垃圾回收时关闭
- 旨在平衡资源使用与运营可靠性的连接管理
- 健壮的重试逻辑用于外部服务（如 Ollama），以处理临时连接问题
安全注意事项
- 服务器仅处理指定邮箱的电子邮件
- 所有数据本地存储（SQLite）并在 MongoDB 中
- 除本地 Ollama 服务器外，没有进行任何外部 API 调用
- 需要明确用户批准才能进行电子邮件处理
- 通过 MCP 接口不会暴露任何敏感的电子邮件数据
调试
遇到问题时：
- 验证电子邮件是否成功处理（检查 process_emails 响应）
- 确保 Ollama 服务器在嵌入生成期间运行
- 检查 SQLite 数据库是否可访问
- 验证 MongoDB 连接是否正常工作