🚀 电子邮件处理 MCP 服务器

本 MCP 服务器具备强大的电子邮件处理能力，它集成了 MongoDB 用于语义搜索，同时结合 SQLite 实现高效的电子邮件存储与检索。

🚀 快速开始

此 MCP 服务器提供了一系列丰富的功能，可对 Outlook 电子邮件进行高效处理，同时支持多邮箱操作，为用户带来便捷的邮件管理体验。

✨ 主要特性

当前功能

• 能够处理带有日期范围过滤的 Outlook 电子邮件，方便用户筛选特定时间段内的邮件。
• 在 SQLite 数据库中存储电子邮件，并进行适当的连接管理，确保数据的稳定存储。
• 借助 Ollama 生成向量嵌入，为后续的语义搜索等功能提供支持。
• 支持多邮箱，满足用户管理多个邮箱的需求。
• 支持 Inbox、Sent Items 和可选的 Deleted Items 文件夹，全面覆盖常见的邮件文件夹。

待实现功能

• 带有语义能力的电子邮件搜索，提升搜索的准确性和效率。
• 使用 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. 安装依赖项：

uv pip install -e .

5. 安装 fastmcp 包：

uv pip install fastmcp

6. 确保 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"

架构

服务器采用混合搜索方法：

1. SQLite 数据库：
   • 作为主电子邮件存储库。
   • 具备全文搜索功能。
   • 可进行处理状态跟踪。
   • 支持高效过滤。
   • 若目录不存在，可自动创建。
   • 服务器关闭时，会正确关闭连接，防止“无法操作已关闭数据库”错误。
2. MongoDB：
   • 用于存储嵌入式向量。
   • 支持语义相似性搜索。
   • 可进行元数据过滤。
   • 实现高效检索。
   • 服务器关闭后，会正确关闭连接。

错误处理

服务器提供详细的错误消息，针对以下常见问题：

• 无效日期格式。
• 与 Outlook 的连接问题。
• MongoDB 错误。
• 嵌入式生成失败并带有重试逻辑。
• SQLite 存储错误。
• Ollama 服务器连接问题的自动重试。

资源管理

服务器实现了适当的资源管理，以防止出现问题：

• 数据库连接（SQLite 和 MongoDB）在服务器生命周期内保持打开状态，防止“无法操作已关闭数据库”错误。
• 连接仅在服务器关闭时关闭，使用 atexit 处理器。
• 使用破坏性和上下文管理器作为最后手段，确保连接在对象垃圾回收时关闭。
• 旨在平衡资源使用与运营可靠性的连接管理。
• 针对外部服务（如 Ollama）采用健壮的重试逻辑，以处理临时连接问题。

安全注意事项

• 服务器仅处理指定邮箱的电子邮件。
• 所有数据本地存储（SQLite）并存储在 MongoDB 中。
• 除本地 Ollama 服务器外，不进行任何外部 API 调用。
• 需要明确用户批准才能进行电子邮件处理。
• 通过 MCP 接口不会暴露任何敏感的电子邮件数据。

调试

遇到问题时，可按以下步骤进行排查：

1. 验证电子邮件是否成功处理（检查 process_emails 响应）。
2. 确保 Ollama 服务器在嵌入生成期间运行。
3. 检查 SQLite 数据库是否可访问。
4. 验证 MongoDB 连接是否正常工作。