金大哥 - mcp-server-outlook-email MCP 详情

article

README

🚀 邮件处理 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 接口暴露，保护用户敏感信息。

📞 最后说明

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

mcp-server-outlook-email