Outlook MCP Server

🚀 Outlook MCP 服务器

Outlook MCP 服务器是一个提供 Microsoft Outlook 邮件功能访问的模型上下文协议（MCP）服务器。它允许大语言模型（LLMs）和其他 MCP 客户端，通过标准化接口读取、搜索和管理邮件，为邮件操作提供了便捷、高效的解决方案。

🚀 快速开始

Outlook MCP 服务器可让大语言模型和 MCP 客户端通过标准化接口，对 Outlook 邮件进行读取、搜索和管理。使用前需确保满足先决条件，完成安装和配置。

✨ 主要特性

• 文件夹管理：能够列出 Outlook 客户端中的可用邮件文件夹，方便用户快速定位所需文件夹。
• 邮件列表：可按时间段检索邮件，用户能根据自己的需求查看特定时间段内的邮件。
• 邮件搜索：支持通过联系人姓名、关键词或短语（支持 OR 运算符）搜索邮件，提高查找邮件的效率。
• 邮件详情：可以查看完整的邮件内容，包括附件，让用户全面了解邮件信息。
• 邮件撰写：允许用户创建并发送新邮件，满足日常邮件沟通需求。
• 邮件回复：支持回复现有邮件，方便用户及时响应邮件。

📦 安装指南

先决条件

• 需使用 Windows 操作系统。
• Python 版本需为 3.10 或更高版本。
• Microsoft Outlook 已安装并配置了有效的帐户。
• 安装了 Claude Desktop 或其他与 MCP 兼容的客户端。

安装步骤

1. 克隆或下载此仓库。
2. 安装所需的依赖项：

pip install mcp>=1.2.0 pywin32>=305

3. 配置 Claude Desktop（或其他首选 MCP 客户端）以使用此服务器。

配置

Claude Desktop 配置

在你的 MCP_client_config.json 文件中添加以下内容：

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

💻 使用示例

启动服务器

你可以直接启动服务器：

python outlook_mcp_server.py

或者允许像 Claude Desktop 这样的 MCP 客户端通过配置启动它。

可用工具

该服务器提供以下工具：

1. list_folders：列出 Outlook 中的所有可用邮件文件夹。
2. list_recent_emails：按指定天数显示最近的邮件标题。
3. search_emails：按联系人姓名或关键词搜索邮件。
4. get_email_by_number：检索特定邮件的详细内容。
5. reply_to_email_by_number：回复特定邮件。
6. compose_email：创建并发送新邮件。

示例工作流程

1. 使用 list_folders 查看所有可用邮件文件夹。
2. 使用 list_recent_emails 查看最近的邮件（例如，过去 7 天）。
3. 使用 search_emails 搜索特定关键词的邮件。
4. 使用 get_email_by_number 查看完整的邮件内容。
5. 使用 reply_to_email_by_number 回复邮件。

具体示例

列出最近邮件

你能展示我过去 3 天内未读邮件吗？

搜索邮件

搜索过去一周关于 "项目更新 或 会议纪要" 的邮件

查看邮件详情

显示列表中第 2 封邮件的详细信息

回复邮件

回复第 3 封邮件，内容为："感谢你的信息。我会审阅并明天回复你。"

撰写新邮件

发送一封主题为 "会议议程"、收件人为 john.doe@example.com 且正文为 "这是我们下次会议的议程..." 的邮件

📚 详细文档

故障排除

• 连接问题：确保 Outlook 正在运行并且配置正确。
• 权限错误：确保脚本有权访问 Outlook。
• 搜索问题：对于复杂的搜索，尝试在关键词之间使用 OR 运算符。
• 邮件访问错误：检查邮箱 ID 是否有效且可访问。
• 服务器崩溃：检查 Outlook 的连接和稳定性。

安全注意事项

此服务器可以访问你的 Outlook 邮件帐户，并能够读取、发送和管理邮件。仅在受信任的 MCP 客户端和安全环境中使用。

限制

• 当前仅支持纯文本邮件（不支持 HTML）。
• 最大邮件历史记录为 30 天。
• 搜索功能依赖于 Outlook 的内置搜索功能。
• 只支持基本的邮件功能（无日历、联系人等）。