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

安装步骤

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 接口暴露

最后说明

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