🚀 Outlook MCP 服务器
Outlook MCP 服务器是一个提供 Microsoft Outlook 邮件功能访问的模型上下文协议（MCP）服务器。它允许大语言模型（LLMs）和其他 MCP 客户端，通过标准化接口读取、搜索和管理邮件，为邮件操作提供了便捷、高效的解决方案。
🚀 快速开始
Outlook MCP 服务器可让大语言模型和 MCP 客户端通过标准化接口，对 Outlook 邮件进行读取、搜索和管理。使用前需确保满足先决条件，完成安装和配置。
✨ 主要特性
- 文件夹管理：能够列出 Outlook 客户端中的可用邮件文件夹，方便用户快速定位所需文件夹。
- 邮件列表：可按时间段检索邮件，用户能根据自己的需求查看特定时间段内的邮件。
- 邮件搜索：支持通过联系人姓名、关键词或短语（支持 OR 运算符）搜索邮件，提高查找邮件的效率。
- 邮件详情：可以查看完整的邮件内容，包括附件，让用户全面了解邮件信息。
- 邮件撰写：允许用户创建并发送新邮件，满足日常邮件沟通需求。
- 邮件回复：支持回复现有邮件，方便用户及时响应邮件。
📦 安装指南
先决条件
- 需使用 Windows 操作系统。
- Python 版本需为 3.10 或更高版本。
- Microsoft Outlook 已安装并配置了有效的帐户。
- 安装了 Claude Desktop 或其他与 MCP 兼容的客户端。
安装步骤
- 克隆或下载此仓库。
- 安装所需的依赖项：
pip install mcp>=1.2.0 pywin32>=305
- 配置 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 客户端通过配置启动它。
可用工具
该服务器提供以下工具：
list_folders：列出 Outlook 中的所有可用邮件文件夹。list_recent_emails：按指定天数显示最近的邮件标题。search_emails：按联系人姓名或关键词搜索邮件。get_email_by_number：检索特定邮件的详细内容。reply_to_email_by_number：回复特定邮件。compose_email：创建并发送新邮件。
示例工作流程
- 使用
list_folders查看所有可用邮件文件夹。 - 使用
list_recent_emails查看最近的邮件（例如，过去 7 天）。 - 使用
search_emails搜索特定关键词的邮件。 - 使用
get_email_by_number查看完整的邮件内容。 - 使用
reply_to_email_by_number回复邮件。
具体示例
列出最近邮件
你能展示我过去 3 天内未读邮件吗？
搜索邮件
搜索过去一周关于 "项目更新 或 会议纪要" 的邮件
查看邮件详情
显示列表中第 2 封邮件的详细信息
回复邮件
回复第 3 封邮件，内容为："感谢你的信息。我会审阅并明天回复你。"
撰写新邮件
发送一封主题为 "会议议程"、收件人为 john.doe@example.com 且正文为 "这是我们下次会议的议程..." 的邮件
📚 详细文档
故障排除
- 连接问题：确保 Outlook 正在运行并且配置正确。
- 权限错误：确保脚本有权访问 Outlook。
- 搜索问题：对于复杂的搜索，尝试在关键词之间使用 OR 运算符。
- 邮件访问错误：检查邮箱 ID 是否有效且可访问。
- 服务器崩溃：检查 Outlook 的连接和稳定性。
安全注意事项
此服务器可以访问你的 Outlook 邮件帐户，并能够读取、发送和管理邮件。仅在受信任的 MCP 客户端和安全环境中使用。
限制
- 当前仅支持纯文本邮件（不支持 HTML）。
- 最大邮件历史记录为 30 天。
- 搜索功能依赖于 Outlook 的内置搜索功能。
- 只支持基本的邮件功能（无日历、联系人等）。