Serwer MCP Mail Viewer: konwersja i analiza e-maili z pomocą AI

CoolUtils Mail Viewer zawiera wbudowany serwer MCP (Model Context Protocol). Uruchom MailViewer.exe --mcp, a program pominie swój interfejs graficzny i stanie się serwerem działającym w tle, który asystenci AI mogą wywoływać bezpośrednio. Claude Code, Claude Desktop, Cursor, Cline oraz każdy agent zgodny z MCP mogą wtedy konwertować, odczytywać i wyodrębniać załączniki z plików e-mail — reagując na polecenia w naturalnym języku, bez żadnych własnych skryptów.

Czym jest MCP?

Model Context Protocol to otwarty standard opublikowany przez Anthropic, który pozwala agentom AI wywoływać oprogramowanie na komputerze tak, jakby korzystali ze zdalnego API. Zamiast pisać skrypty lub używać wiersza poleceń, opisujesz po prostu, czego potrzebujesz. Agent ustala parametry i wywołuje odpowiednie narzędzie — w tym przypadku Mail Viewer działający cicho w tle.

Serwer MCP jest wbudowany bezpośrednio w plik wykonywalny MailViewer.exe. Nie ma nic dodatkowego do zainstalowania ani licencjonowania. Flaga --mcp zmienia jedynie zachowanie przy uruchomieniu: interfejs graficzny jest ukryty, a w tle uruchamiany jest wątek odczytujący dane ze stdio.

Co możesz zrobić

Po podłączeniu możesz wydawać asystentowi AI polecenia takie jak:

Trzy dostępne narzędzia

convert_mail

Konwertuje plik e-mail do określonego formatu wyjściowego. Używa pełnego silnika renderowania Mail Viewer, więc wyjście PDF i DOCX zawiera osadzony HTML, obrazy inline, podglądy załączników i nagłówki wiadomości — identyczne z tym, co widać w interfejsie graficznym.

Formaty źródłowe: .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact, .3uc
Formaty wyjściowe: pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml, xps

get_mail_info

Odczytuje plik e-mail i zwraca jego metadane jako JSON: nadawca, odbiorcy Do/CC/BCC, temat, data, surowe nagłówki RFC, treść w postaci zwykłego tekstu i HTML oraz lista załączników z nazwami, rozmiarami i typami zawartości. Plik źródłowy nie jest modyfikowany.

extract_attachments

Zapisuje wszystkie załączniki z pliku e-mail do docelowego folderu (tworzonego automatycznie, jeśli nie istnieje). Zwraca listę zapisanych plików z ich bezwzględnymi ścieżkami i rozmiarami w bajtach.

Podłączenie do Claude Code

Dodaj poniższy blok do pliku ~/.claude.json wewnątrz obiektu mcpServers (utwórz klucz, jeśli nie istnieje):

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

Gotowy do skopiowania fragment konfiguracji jest zainstalowany obok pliku wykonywalnego jako claude-config-snippet.json. Dostosuj ścieżkę, jeśli zainstalowałeś Mail Viewer w niestandardowej lokalizacji.

Podłączenie do Claude Desktop

Otwórz plik %APPDATA%\Claude\claude_desktop_config.json i dodaj ten sam blok w sekcji mcpServers:

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

Ten sam format konfiguracji działa dla Cursor, Cline i każdego innego agenta obsługującego standard Model Context Protocol.

Weryfikacja instalacji

Uruchom poniższe polecenie w wierszu poleceń, aby sprawdzić, czy serwer MCP odpowiada poprawnie:

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

Powinieneś zobaczyć pojedynczą odpowiedź JSON-RPC zawierającą protocolVersion, serverInfo oraz możliwość tools. Jeśli się pojawi, serwer jest gotowy do użycia.

Szczegóły techniczne

Dla programistów i integratorów: serwer komunikuje się przez stdio przy użyciu NDJSON (jedna wiadomość JSON-RPC 2.0 w wierszu, kodowanie UTF-8). Wersja protokołu: 2024-11-05. Nazwa serwera raportowana w initialize: mailviewer-mcp. Pełne schematy wejściowe dla wszystkich trzech narzędzi są zainstalowane obok pliku wykonywalnego jako mcp-tools.json. Czytelny maszynowo manifest serwera jest dostępny jako mcp-server.json.