MCP-сервер Mail Viewer: конвертация и просмотр писем с помощью ИИ

CoolUtils Mail Viewer включает встроенный MCP-сервер (Model Context Protocol). Запустите MailViewer.exe --mcp — программа пропустит графический интерфейс и станет фоновым сервером, к которому ИИ-ассистенты могут обращаться напрямую. Claude Code, Claude Desktop, Cursor, Cline и любой совместимый с MCP агент смогут конвертировать, читать и извлекать вложения из почтовых файлов — реагируя на инструкции на обычном языке, без написания скриптов.

Что такое MCP?

Model Context Protocol — это открытый стандарт, опубликованный компанией Anthropic, позволяющий ИИ-агентам вызывать настольное программное обеспечение как удалённый API. Вместо написания скриптов или работы с командной строкой вы описываете задачу обычными словами. Агент сам определяет параметры и вызывает нужный инструмент — в данном случае Mail Viewer, работающий в фоновом режиме.

MCP-сервер встроен прямо в исполняемый файл MailViewer.exe. Ничего дополнительно устанавливать или приобретать не нужно. Флаг --mcp лишь меняет режим запуска: графический интерфейс скрывается, и стартует фоновый поток чтения через stdio.

Что можно делать

После подключения вы можете давать ИИ-ассистенту инструкции вроде следующих:

Три доступных инструмента

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: отправитель, получатели To/CC/BCC, тема, дата, необработанные 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

В ответ должна появиться одна строка JSON-RPC, содержащая protocolVersion, serverInfo и возможность tools. Если она появилась — сервер готов к работе.

Технические подробности

Для разработчиков и интеграторов: сервер взаимодействует через stdio с использованием NDJSON (одно сообщение JSON-RPC 2.0 на строку, кодировка UTF-8). Версия протокола: 2024-11-05. Имя сервера в ответе initialize: mailviewer-mcp. Полные входные схемы для всех трёх инструментов установлены рядом с исполняемым файлом как mcp-tools.json. Машиночитаемый манифест сервера доступен как mcp-server.json.