خادم MCP للبريد الإلكتروني

ما الذي يفعله خادم “البريد الإلكتروني” MCP؟

خادم MCP للبريد الإلكتروني هو خادم بروتوكول سياق النماذج (MCP) بسيط يُمكّن مساعد الذكاء الاصطناعي الخاص بك من إرسال رسائل البريد الإلكتروني وإرفاق الملفات عبر SMTP. يعمل كجسر بين وكلاء الذكاء الاصطناعي وأنظمة البريد الإلكتروني الخارجية، ويوفر أدوات لإرسال رسائل بريد إلكتروني أساسية ومتقدمة، بما في ذلك محتوى HTML، مرفقات الملفات، دعم CC/BCC، واختبار الاتصال بـ SMTP. يسهّل هذا الخادم سير العمل من خلال تمكين المطورين ووكلاء الذكاء الاصطناعي من أتمتة مهام التواصل، والتحقق من إعدادات SMTP، وإدارة إعدادات البريد الإلكتروني برمجيًا—مما يوسع قدرة المساعد على التفاعل مع أنظمة المراسلة الواقعية ويعزز الإنتاجية في سيناريوهات التطوير والأتمتة.

قائمة القوالب

لا توجد قوالب موجهات موثقة صراحة في المستودع. هذا القسم فارغ.

قائمة الموارد

لا توجد موارد MCP موثقة صراحة في الوثائق أو الشيفرة. هذا القسم فارغ.

قائمة الأدوات

• send_email
  أداة بسيطة لإرسال رسائل بريد إلكتروني نصية عادية أو بتنسيق HTML إلى المستلمين باستخدام إعدادات SMTP الخاصة بك. يتطلب تحديد المستلم، والعنوان، والمحتوى.

• send_custom_email
  أداة إرسال بريد إلكتروني متقدمة تدعم CC/BCC، مرفقات الملفات، تنسيق HTML، وإمكانية تجاوز إعدادات SMTP لكل رسالة بريد إلكتروني.

• test_smtp_connection_tool
  أداة مساعدة للتحقق من إعدادات SMTP والتأكد من أن إرسال البريد الإلكتروني مضبوط بشكل صحيح قبل الاستخدام.

حالات الاستخدام لهذا الخادم MCP

• إشعارات البريد الإلكتروني المؤتمتة
  يمكن لوكلاء الذكاء الاصطناعي إرسال إشعارات فورية، تذكيرات، أو تحديثات حالة للمستخدمين أو الفرق عبر البريد الإلكتروني، مما يبسط سير عمل التواصل.

• توزيع الملفات والتقارير
  توزيع التقارير أو السجلات أو الوثائق المولدة كمرفقات إلى مستلم واحد أو أكثر، وتقليل خطوات المشاركة اليدوية.

• إعلانات الفريق مع التنسيق
  استخدم دعم HTML لصياغة تحديثات فرق جذابة بصريًا أو نشرات إخبارية بتنسيق غني وعدة مستلمين عبر CC/BCC.

• التحقق من إعداد SMTP
  يمكن للمطورين التحقق بسرعة من إعدادات SMTP لتجنب فشل تسليم البريد الإلكتروني أثناء النشر أو مراحل التكامل.

• أتمتة التواصل الشخصي
  أتمتة إرسال رسائل بريد إلكتروني مخصصة لعمليات الانضمام أو دعم العملاء أو المتابعة، مستفيدًا من الذكاء الاصطناعي لصياغة الرسائل وتسليمها على نطاق واسع.

كيفية إعداده

Windsurf

لا توجد تعليمات إعداد محددة لـ Windsurf في المستودع.

Claude

1. تثبيت البرامج المطلوبة

   • تثبيت uv (مدير حزم بايثون):
     curl -LsSf https://astral.sh/uv/install.sh | sh
     أعد تشغيل الطرفية أو نفذ source ~/.bashrc

2. تثبيت تبعيات المشروع

   • cd email-mcp-server
   • uv sync

3. اختبار التثبيت

   • uv run python test_email.py
   • (اختياري) تشغيل الخادم: uv run main.py

4. إعداد Claude Desktop

   • عدّل إعدادات Claude Desktop وأضف:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

هام: قم بتحديث مسار الدليل ليتطابق مع مكان التثبيت الخاص بك.

Cursor

1. تثبيت البرامج المطلوبة

   • تثبيت uv:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     أعد تشغيل الطرفية أو نفذ source ~/.bashrc

2. تثبيت تبعيات المشروع

   • cd email-mcp-server
   • uv sync

3. اختبار التثبيت

   • uv run python test_email.py
   • (اختياري) تشغيل الخادم: uv run main.py

4. إعداد Cursor

   • عدّل ملف الإعدادات الخاص بك وأضف:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

هام: قم بتحديث مسار الدليل ليتطابق مع مكان التثبيت الخاص بك.

Cline

لا توجد تعليمات إعداد محددة لـ Cline في المستودع.

تأمين مفاتيح API باستخدام متغيرات البيئة

قم بإعداد بيانات اعتماد SMTP الحساسة عبر قسم env في إعدادات خادم MCP الخاص بك. مثال:

"env": {
  "SMTP_HOST": "smtp.gmail.com",
  "SMTP_PORT": "587",
  "SMTP_SECURE": "false",
  "SMTP_USER": "your-email@gmail.com",
  "SMTP_FROM": "your-email@gmail.com",
  "SMTP_PASS": "your-app-password"
}

خزن الأسرار الفعلية خارج ملف الإعداد متى أمكن.

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق لـ JSON:

{
  "email-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي الآن من استخدام هذا MCP كأداة مع إمكانية الوصول لجميع وظائفه وقدراته. تذكر تغيير “email-mcp” للاسم الفعلي وتحديث الرابط حسب الحاجة.

نظرة عامة

دعم الجذور: غير مذكور

دعم sampling: غير مذكور

استنادًا إلى الجدول أعلاه، يوفر خادم MCP للبريد الإلكتروني أدوات قوية وواضحة لأتمتة البريد الإلكتروني، لكنه يفتقر إلى قوالب موجهات موثقة، وموارد MCP صريحة، ومعلومات حول ميزات البروتوكول المتقدمة مثل الجذور أو sampling. عملية الإعداد مباشرة لكل من Claude وCursor، مع دعم واضح لمتغيرات البيئة.

رأينا

هذا الخادم MCP مباشر وواضح التوثيق فيما يتعلق بحالة استخدامه الأساسية، لكنه يفتقر إلى ميزات MCP متقدمة وموارد إضافية. إنه فعال للغاية لمهام البريد الإلكتروني لكنه محدود في القابلية للتوسعة وعمق البروتوكول. أقيمه 6 من 10 من حيث الفائدة الأساسية والتوثيق، مع مجال للتحسين في اكتمال الميزات وتغطية بروتوكول MCP.

تقييم MCP