🚀 邮件处理 MCP 服务器
此 MCP 服务器专注于邮件处理，集成了 MongoDB 用于语义搜索，同时采用 SQLite 实现高效的邮件存储与检索，为用户提供稳定且功能丰富的邮件处理体验。
🚀 快速开始
此 MCP 服务器提供强大的邮件处理功能，借助 MongoDB 实现语义搜索，利用 SQLite 完成高效存储与检索。以下是使用该服务器的快速指引。
✨ 主要特性
- 多邮箱支持：支持多个邮箱，满足不同用户的多样化需求。
- 多文件夹处理：支持 Outlook 的 Inbox、Sent Items 文件夹，还可选择处理 Deleted Items 文件夹。
- 高效存储：将邮件存储在 SQLite 数据库中，并确保连接管理得当。
- 向量嵌入生成：使用 Ollama 生成向量嵌入，为后续的语义处理提供支持。
- 日期范围过滤：能够处理带有日期范围过滤的 Outlook 邮件。
📅 计划功能
- 语义邮件搜索：实现带有语义能力的邮件搜索，让搜索更加精准。
- 邮件摘要生成：使用 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 - 安装依赖项：
pip install -r requirements.txt - 运行服务器：
python server.py
🛠️ 配置指南
将以下内容添加到配置文件中：
{
"mongodb": {
"uri": "mongodb://localhost:27017",
"database": "email_processing"
},
"sqlite": {
"path": "emails.db"
},
"ollama": {
"url": "http://localhost:11434"
}
}
详细配置
- MongoDB 配置：需指定连接 URI 和数据库名称。
- SQLite 配置：需指定数据库文件路径。
- Ollama 配置：需指定服务地址。
💻 使用示例
基础用法
获取邮件处理状态：
from server import EmailProcessor
processor = EmailProcessor()
status = processor.get_status()
print(status)
❌ 错误处理
常见的错误包括：
- 无效的日期格式
- Outlook 连接问题
- MongoDB 错误
- 嵌入生成失败
- 数据库存储错误
- Ollama 服务器连接问题
🐞 调试指南
- 检查邮件是否成功处理（查看 process_emails 响应）。
- 确保 Ollama 服务器正在运行，以便进行嵌入生成。
- 检查 SQLite 数据库的访问权限。
- 验证 MongoDB 连接状态。
🔒 安全注意事项
- 服务器仅处理指定邮箱中的邮件，确保数据处理范围可控。
- 所有数据均存储在本地（SQLite 和 MongoDB），保障数据安全。
- 无外部 API 调用，仅与本地 Ollama 服务器通信，减少数据泄露风险。
- 邮件处理需要明确用户批准，尊重用户隐私。
- 无敏感邮件数据通过 MCP 接口暴露，保护用户敏感信息。
📞 最后说明
如有任何问题或建议，请联系支持团队。