🚀 邮件处理 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 服务器，用于存储嵌入。

安装步骤

1. 安装 uv（若尚未安装）：

   pip install uv
   

2. 创建虚拟环境：

   uv venv .venv
   

3. 激活虚拟环境：
   • Windows：

   .venv\Scripts\activate
   

   • macOS/Linux：

   source .venv/bin/activate
   

4. 安装依赖项：

   pip install -r requirements.txt
   

5. 运行服务器：

   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 服务器连接问题

🐞 调试指南

1. 检查邮件是否成功处理（查看 process_emails 响应）。
2. 确保 Ollama 服务器正在运行，以便进行嵌入生成。
3. 检查 SQLite 数据库的访问权限。
4. 验证 MongoDB 连接状态。

🔒 安全注意事项

• 服务器仅处理指定邮箱中的邮件，确保数据处理范围可控。
• 所有数据均存储在本地（SQLite 和 MongoDB），保障数据安全。
• 无外部 API 调用，仅与本地 Ollama 服务器通信，减少数据泄露风险。
• 邮件处理需要明确用户批准，尊重用户隐私。
• 无敏感邮件数据通过 MCP 接口暴露，保护用户敏感信息。

📞 最后说明

如有任何问题或建议，请联系支持团队。