🚀 Outlook MCP 服务器
Outlook MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务，它为大语言模型和其他 MCP 客户端提供了标准化接口，使其能够方便地访问 Microsoft Outlook 的邮件功能，实现邮件的读取、搜索与管理操作。
🚀 快速开始
要使用 Outlook MCP 服务器，你需要满足以下先决条件，并按照安装步骤进行操作：
先决条件
- 操作系统为 Windows。
- 安装 Python 3.11 或更高版本。
- 已安装 Microsoft Outlook 并配置了活跃账户。
- 准备好 Claude Desktop 或其他 MCP 兼容客户端。
安装步骤
- 克隆或下载此仓库。
- 安装所需的依赖项，在命令行中执行以下命令：
pip install mcp>=1.2.0 pywin32>=305
- 配置 Claude Desktop（或其他 MCP 客户端）以自动启动该服务器。
客户端配置
将以下内容添加到你的 MCP 客户端配置中：
{
"mcpServers": {
"outlook": {
"isActive": true,
"name": "outlook",
"description": "Outlook 工具",
"command": "python",
"args": [
"${workspaceFolder}/outlook_mcp_server.py"
]
}
}
}
✨ 主要特性
- 文件夹管理：可列出 Outlook 客户端中的所有可用邮件文件夹。
- 邮件列表：能从指定时间段内检索邮件。
- 邮件搜索：支持根据联系人姓名、关键词或短语（支持 OR 运算符）搜索邮件。
- 邮件详细信息：可查看完整的邮件内容，包括附件。
- 邮件编写：能够创建并发送新邮件。
- 邮件回复：可对现有的邮件进行回复。
💻 使用示例
基础用法
将配置信息添加到 MCP 客户端后，你就可以使用服务器提供的各种工具了。以下是各工具的详细介绍：
-
list_folders：
- 列出 Outlook 中的所有可用邮件文件夹。
- 显示文件夹层次结构，最多显示三级深度。
- 返回格式化的文件夹和子文件夹列表。
-
list_recent_emails：
- 列出指定天数（1 - 30）内的邮件标题。
- 可以指定要搜索的文件夹（默认为收件箱）。
- 缓存结果以便于详细查看。
- 返回找到的邮件数量和查看它们的说明。
-
search_emails：
- 根据联系人姓名或关键词搜索邮件。
- 支持 OR 运算符用于多个搜索词。
- 搜索主题、发件人名称和正文内容。
- 返回匹配项的数量和查看它们的说明。
-
view_email_cache：
- 浏览缓存邮件，每页显示 5 条。
- 显示邮件主题、发件人、接收时间和已读状态。
- 提供上一页/下一页导航。
- 需要先使用
list_recent_emails或search_emails。
-
get_email_by_number：
- 根据编号检索特定邮件的详细内容。
- 显示完整的正文、收件人和附件。
- 需要从缓存列表中提供邮件编号。
- 提供回复邮件的选项。
-
reply_to_email_by_number：
- 根据编号回复特定邮件。
- 使用缓存列表中的邮件编号。
- 发送带有指定正文内容的回复。
- 维持原始邮件线程。
- 可选：指定“收件人”和“抄送”字段的自定义收件人。
- 默认行为是回复所有（发件人 + 抄送）。
- 允许覆盖默认收件人如果需要。
-
compose_email：
- 创建并发送新邮件。
- 支持收件人、主题和正文内容。
- 可选 CC 字段用于添加更多收件人。
- 通过 Outlook 客户端处理邮件发送。
高级用法
示例工作流程
- 使用
list_folders查看所有可用的邮件文件夹。 - 使用
list_recent_emails查看最近的邮件（例如，过去 7 天内的）。 - 使用
search_emails根据关键词搜索邮件。 - 使用
view_email_cache浏览缓存的邮件。 - 使用
get_email_by_number查看特定邮件的详细信息。 - 使用
reply_to_email_by_number回复邮件。 - 使用
compose_email创建并发送新邮件。
⚠️ 重要提示
⚠️ 重要提示
此服务器可以访问你的 Outlook 邮件账户，并且可以读取、发送和管理邮件。仅在受信任的 MCP 客户端和安全环境中使用它。
🔧 技术细节
- 当前仅支持纯文本邮件（不支持 HTML）。
- 最大邮件历史限制为 30 天。
- 搜索功能依赖于 Outlook 的内置搜索功能。
- 仅支持基本邮件功能（无日历、联系人等）。