Mail Viewer MCP 服务器：AI 驱动的电子邮件转换与检查

CoolUtils Mail Viewer 内置了 MCP（Model Context Protocol）服务器。运行 MailViewer.exe --mcp，程序将跳过图形界面，作为后台服务器运行，供 AI 助手直接调用。Claude Code、Claude Desktop、Cursor、Cline 以及任何支持 MCP 的代理均可转换、读取并提取电子邮件文件中的附件，只需用自然语言描述需求，无需任何自定义脚本。

什么是 MCP？

Model Context Protocol 是 Anthropic 发布的开放标准，允许 AI 代理像调用远程 API 一样调用桌面软件。您无需编写脚本或使用命令行，只需用自然语言描述需求，代理会自动解析参数并调用相应工具——在本例中，即在后台静默运行的 Mail Viewer。

MCP 服务器已内置于常规的 MailViewer.exe 二进制文件中，无需额外安装或授权。--mcp 标志仅改变启动行为：隐藏图形界面，并启动后台 stdio 读取线程。

您可以做什么

连接后，您可以向 AI 助手发出如下指令：

三个可用工具

convert_mail

将邮件文件转换为指定输出格式。使用完整的 Mail Viewer 渲染引擎，因此 PDF 和 DOCX 输出包含嵌入式 HTML、内联图片、附件预览和邮件头——与图形界面中看到的完全相同。

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

get_mail_info

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

extract_attachments

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

连接到 Claude Code

在您的 ~/.claude.json 文件的 mcpServers 对象中添加以下代码块（如果该键不存在则创建）：

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

可直接复制粘贴的代码片段已作为 claude-config-snippet.json 安装在可执行文件旁边。如果您将 Mail Viewer 安装在非默认位置，请相应调整路径。

连接到 Claude Desktop

打开 %APPDATA%\Claude\claude_desktop_config.json，在 mcpServers 下添加相同的代码块：

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

相同的配置格式适用于 Cursor、Cline 以及任何其他支持 Model Context Protocol 标准的代理。

验证安装

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

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

您应看到一条包含 protocolVersion、serverInfo 和 tools 能力的 JSON-RPC 响应。如果出现，则服务器已准备好使用。

技术细节

面向开发者和集成商：服务器通过 stdio 使用 NDJSON 进行通信（每行一条 JSON-RPC 2.0 消息，UTF-8 编码）。协议版本：2024-11-05。initialize 中报告的服务器名称：mailviewer-mcp。所有三个工具的完整输入 schema 已作为 mcp-tools.json 安装在可执行文件旁边。机器可读的服务器清单可作为 mcp-server.json 获取。