CoolUtils Mail Viewer

Mail Viewer MCP 服务

一个 Model Context Protocol 服务，可让 Claude、Cursor、Cline 和任何兼容 MCP 的 AI Agent 读取、转换电子邮件文件并提取附件，支持 .eml、.msg、.p7m、.mim、.tnef、.vcf、.olk15 等格式。

该服务内置于 CoolUtils Mail Viewer，无需额外安装。运行 MailViewer.exe --mcp，程序便会跳过图形界面，以 stdio JSON-RPC 服务的形式运行。

你可以做什么

连接后，可以用自然语言向 AI 助手下达指令：

• “将 D:\archive 中的所有 .msg 文件转换为 PDF，并放入 D:\output”——Agent 会对每个文件调用 convert_mail。
• “这个 EML 有哪些附件，是谁发来的？”——get_mail_info 会立即返回整洁的 JSON 对象。
• “将这 40 封邮件中的所有附件提取到 C:\attachments”——extract_attachments 会一次性保存所有附件。

所有操作都在本地运行，你的邮件文件绝不会上传到任何地方。

工具

convert_mail

使用完整的 Mail Viewer 渲染引擎将邮件文件转换为指定的输出格式。

• 源格式： .eml、.msg、.mim、.p7m、.vmbx、.tnef、.mapixml、.olk15、.vcf、.contact、.3uc
• 输出格式： pdf、html、txt、doc、rtf、tiff、jpg、png、bmp、emf、eml、xps

PDF 和 DOCX 输出会保留嵌入的 HTML、内嵌图片、附件预览和邮件头，与图形界面中的显示完全一致。

get_mail_info

读取邮件文件，并以 JSON 格式返回其元数据：发件人、To/CC/BCC 收件人、主题、日期、原始 RFC 邮件头、纯文本和 HTML 正文，以及包含名称、大小和内容类型的附件列表。不会修改源文件。

extract_attachments

将邮件文件中的所有附件保存到目标文件夹（如果文件夹不存在，会自动创建）。返回已保存文件的列表，其中包含绝对路径和以字节为单位的大小。

完整的输入/输出架构：schemas/mcp-tools.json。

安装

1. 安装 Mail Viewer

从 https://www.coolutils.com/MailViewer 下载并安装适用于 Windows 的 CoolUtils Mail Viewer。MCP 服务已打包在标准的 MailViewer.exe 二进制文件中，无需额外的软件包或单独的许可证。

可免费试用 30 天；无需提供电子邮件地址或信用卡信息。

2. 配置 MCP 客户端

Claude Code

在 ~/.claude.json 的 mcpServers 下添加：

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

Claude Desktop

在 %APPDATA%\Claude\claude_desktop_config.json 的 mcpServers 下添加（与上方相同的代码块）。

Cursor

将相同的 JSON 代码块添加到项目中的 .cursor/mcp.json，或全局配置文件 ~/.cursor/mcp.json 中。

Cline

打开 Cline 的 MCP 设置界面，并粘贴相同的代码块。

可直接复制粘贴的代码片段也会随可执行文件一起安装，文件名为 claude-config-snippet.json。如果 Mail Viewer 安装在非默认位置，请调整路径。

3. 验证

在命令提示符中运行以下命令，确认服务能正常响应：

echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp

你应该会看到一条 JSON-RPC 响应，其中包含 protocolVersion、serverInfo 和 tools 功能。

示例会话

端到端对话记录请参阅 examples/usage.md：

• 批量转换文件夹——让 Claude 访问包含 .msg 文件的目录，并请求生成 PDF。
• 取证分诊——让 Claude 总结 100 封邮件中的发件人、主题和附件规律。
• 提取附件——将一个季度法律往来邮件中的所有附件提取到同一个文件夹。

技术详情

• 传输方式： stdio（NDJSON，每行一条 JSON-RPC 2.0 消息，UTF-8）
• 协议版本： 2024-11-05
• 服务名称（在 initialize 中报告）：mailviewer-mcp
• 平台： Windows 7 / 8 / 10 / 11
• 许可证： 商业软件（Mail Viewer）；MIT（此配置/文档仓库）。个人许可证起价为 $49.90，可免费试用 30 天。

服务清单：schemas/mcp-server.json。

故障排除

服务没有响应。 请确认可执行文件路径正确。Windows 上的默认安装路径为 C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe。在 32 位系统上安装时，请使用 C:\Program Files (x86)\…。

Claude 找不到工具。 编辑配置文件后，请重启 MCP 客户端。查看客户端日志——对于 Claude Desktop，请参阅 %APPDATA%\Claude\logs。

文件路径错误。 请在提示词中使用绝对路径。正斜杠 (/) 和反斜杠 (\) 均可使用；路径中包含空格时请加引号。

试用期已结束。 购买许可证——个人许可证起价为 $49.90。MCP 服务可继续使用同一个二进制文件。

资源

• Mail Viewer 产品页面
• coolutils.com 上的 MCP 文章
• Model Context Protocol 规范
• CoolUtils 支持

许可证

此仓库中的配置文件、架构和文档根据 MIT 许可证 发布。CoolUtils Mail Viewer 本身是商业软件——许可信息请参阅产品页面。