Mail Viewer MCPサーバー：AIによるメール変換と内容確認

CoolUtils Mail Viewerには、MCP（Model Context Protocol）サーバーが組み込まれています。MailViewer.exe --mcpを実行すると、プログラムはGUIを起動せず、AIアシスタントが直接呼び出せるバックグラウンドサーバーとして動作します。Claude Code、Claude Desktop、Cursor、Cline、その他のMCP対応エージェントは、カスタムスクリプトを一切書かずに、メールファイルの変換・閲覧・添付ファイルの抽出を自然言語の指示で実行できます。

MCPとは？

Model Context Protocolは、AnthropicがリリースしたオープンスタンダードであーBが、AIエージェントがデスクトップソフトウェアをリモートAPIのように呼び出せるようにするものです。スクリプトを書いたりコマンドラインを使ったりする代わりに、必要なことを自然言語で説明するだけです。エージェントがパラメーターを解決し、適切なツール—この場合はバックグラウンドでサイレントに動作するMail Viewer—を呼び出します。

MCPサーバーは通常のMailViewer.exeバイナリに同梱されています。別途インストールやライセンス取得は不要です。--mcpフラグは起動動作のみを変更します：GUIが非表示になり、バックグラウンドのstdio読み取りスレッドが開始されます。

できること

接続後、AIアシスタントに次のような指示を出すことができます：

3つの利用可能なツール

convert_mail

メールファイルを指定した出力形式に変換します。Mail Viewerのフルレンダリングエンジンを使用するため、PDFおよびDOCX出力には埋め込みHTML・インライン画像・添付ファイルプレビュー・メッセージヘッダーが含まれ、GUIでの表示と同一です。

ソース形式： .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

メールファイルを読み込み、送信者・To/CC/BCC受信者・件名・日付・生のRFCヘッダー・プレーンテキストおよびHTMLの本文・添付ファイルの名前・サイズ・コンテンツタイプのリストをJSONとして返します。ソースファイルは変更されません。

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応答が表示されれば、サーバーは使用可能な状態です。

技術的な詳細

開発者・インテグレーター向け：サーバーはNDJSON（1行1つのJSON-RPC 2.0メッセージ、UTF-8エンコーディング）を使用してstdioで通信します。プロトコルバージョン：2024-11-05。initializeで報告されるサーバー名：mailviewer-mcp。3つのツールのすべての入力スキーマは、実行ファイルと同じ場所にmcp-tools.jsonとしてインストールされています。マシン可読のサーバーマニフェストはmcp-server.jsonとして利用できます。