خادم 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 يتيح لوكلاء الذكاء الاصطناعي استدعاء برامج سطح المكتب كما لو كانت واجهة برمجة تطبيقات بعيدة. بدلاً من كتابة سكريبتات أو استخدام سطر الأوامر، تصف ما تحتاجه بلغة طبيعية. يحدد الوكيل المعاملات ويستدعي الأداة المناسبة — في هذه الحالة 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.