Mail Viewer MCP Server: Conversione e ispezione email tramite IA

CoolUtils Mail Viewer include un server MCP (Model Context Protocol) integrato. Esegui MailViewer.exe --mcp e il programma salta la sua interfaccia grafica, diventando un server in background che gli assistenti IA possono chiamare direttamente. Claude Code, Claude Desktop, Cursor, Cline e qualsiasi agente compatibile MCP possono quindi convertire, leggere ed estrarre allegati dai tuoi file email — rispondendo a istruzioni in linguaggio naturale, senza alcuno script personalizzato.

Cos'è MCP?

Model Context Protocol è uno standard aperto pubblicato da Anthropic che consente agli agenti IA di chiamare software desktop come se fosse un'API remota. Invece di scrivere script o usare la riga di comando, descrivi ciò di cui hai bisogno in linguaggio naturale. L'agente risolve i parametri e invoca lo strumento giusto — in questo caso, Mail Viewer che gira silenziosamente in background.

Il server MCP è incluso nel normale file binario MailViewer.exe. Non c'è nulla di extra da installare o licenziare. Il flag --mcp cambia solo il comportamento di avvio: l'interfaccia grafica è nascosta e viene avviato un thread di lettura stdio in background.

Cosa puoi fare

Una volta connesso, puoi dare al tuo assistente IA istruzioni come queste:

Tre strumenti disponibili

convert_mail

Converte un file email nel formato di output specificato. Utilizza il motore di rendering completo di Mail Viewer, quindi l'output PDF e DOCX include HTML incorporato, immagini inline, anteprime degli allegati e intestazioni del messaggio — identico a ciò che vedi nell'interfaccia grafica.

Formati sorgente: .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact, .3uc
Formati di output: pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml, xps

get_mail_info

Legge un file email e restituisce i suoi metadati come JSON: mittente, destinatari To/CC/BCC, oggetto, data, intestazioni RFC grezze, corpo in testo normale e HTML, e un elenco di allegati con nomi, dimensioni e tipi di contenuto. Il file sorgente non viene modificato.

extract_attachments

Salva tutti gli allegati da un file email in una cartella di destinazione (creata automaticamente se non esiste). Restituisce l'elenco dei file salvati con i loro percorsi assoluti e le dimensioni in byte.

Connetti a Claude Code

Aggiungi il seguente blocco al tuo file ~/.claude.json all'interno dell'oggetto mcpServers (crea la chiave se non esiste):

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

Uno snippet pronto per essere copiato e incollato è installato accanto all'eseguibile come claude-config-snippet.json. Adatta il percorso se hai installato Mail Viewer in una posizione non predefinita.

Connetti a Claude Desktop

Apri %APPDATA%\Claude\claude_desktop_config.json e aggiungi lo stesso blocco sotto mcpServers:

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

Lo stesso formato di configurazione funziona per Cursor, Cline e qualsiasi altro agente che supporta lo standard Model Context Protocol.

Verifica l'installazione

Esegui il seguente comando nel prompt dei comandi per confermare che il server MCP risponde correttamente:

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

Dovresti vedere una singola risposta JSON-RPC contenente protocolVersion, serverInfo e una capacità tools. Se appare, il server è pronto all'uso.

Dettagli tecnici

Per sviluppatori e integratori: il server comunica tramite stdio usando NDJSON (un messaggio JSON-RPC 2.0 per riga, codifica UTF-8). Versione del protocollo: 2024-11-05. Nome del server riportato in initialize: mailviewer-mcp. Gli schemi di input completi per tutti e tre gli strumenti sono installati accanto all'eseguibile come mcp-tools.json. Un manifest del server leggibile automaticamente è disponibile come mcp-server.json.