Skip to content
Back to search

mail-mcp

Self-hosted multi-account Gmail MCP server for Claude (no secrets in repo)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amana-bpo-opc--mail-mcp/badge.svg)](/listings/amana-bpo-opc--mail-mcp)

HTML

<a href="/listings/amana-bpo-opc--mail-mcp"><img src="/api/listings/amana-bpo-opc--mail-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 133 lines
  1. # خادم البريد المتعدد لكلود
  2. خادم يربط كلود مباشرة بعدة حسابات جيميل أو مساحات عمل جوجل، بدون تحويل الرسائل. يتيح لكلود من الجوال أو الحاسوب أن:
  3. - يعرض الحسابات المربوطة.
  4. - يبحث في حساب واحد أو في كل الحسابات معاً.
  5. - يقرأ أي محادثة كاملة ومرفقاتها.
  6. - يرسل رسالة جديدة أو يرد من الحساب الذي تختاره.
  7. - ينشئ مسودة بدون إرسال.
  8. تعليمات الخادم لكلود تلزمه بعرض الرسالة والحساب المرسِل والمستلمين عليك قبل أي إرسال، وألا يرسل إلا بعد موافقتك.
  9. ---
  10. ## كيف يعمل
  11. ```
  12. كلود (جوال / حاسوب / متصفح)
  13. │ مصادقة بكلمة مرورك عند أول ربط
  14. ▼
  15. الخادم ──► حساب ١ حساب ٢ حساب ٣ ... (عبر واجهة جيميل البرمجية)
  16. ```
  17. - **حماية الخادم من الغرباء:** لا يدخل أحد إلى الخادم إلا بعد إدخال كلمة مرور المالك في صفحة الموافقة. لا يُقبل الرجوع إلا إلى عناوين كلود الرسمية. صلاحية الدخول ساعة واحدة وتتجدد تلقائياً، ويمكن إلغاء كل الجلسات بزر واحد.
  18. - **حماية صلاحيات جوجل:** تُخزَّن مشفّرة داخل قاعدة البيانات. حذف أي حساب من لوحة الإدارة يلغي صلاحيته عند جوجل أيضاً.
  19. - **الصلاحيات المطلوبة من جوجل:** القراءة، وإنشاء المسودات، والإرسال. لا يملك الخادم صلاحية حذف الرسائل.
  20. ---
  21. ## خطوات الإعداد (للفريق التقني)
  22. ### ١) مشروع في منصة جوجل السحابية (مرة واحدة)
  23. 1. أنشئ مشروعاً جديداً في منصة جوجل السحابية، وفعّل فيه واجهة جيميل البرمجية (Gmail API).
  24. 2. في إعدادات شاشة الموافقة (Google Auth Platform):
  25. - نوع الجمهور: **External**، لأن حساباتك موزعة على عدة مساحات عمل منفصلة.
  26. - أضف الصلاحيتين:
  27. `https://www.googleapis.com/auth/gmail.readonly`
  28. `https://www.googleapis.com/auth/gmail.compose`
  29. - **مهم:** غيّر حالة النشر إلى **In production**. إذا بقيت على Testing تنتهي صلاحية كل حساب بعد ٧ أيام وتضطر لإعادة الربط.
  30. 3. أنشئ معرّف عميل من نوع **Web application**، وأضف عنوان الرجوع التالي:
  31. `https://<عنوان-الخادم>/admin/google/callback`
  32. 4. احفظ قيمتي `Client ID` و`Client secret`.
  33. **ما ستراه عند الربط:** لأن التطبيق غير موثّق من جوجل، تظهر شاشة تحذير "Google hasn't verified this app". اضغط Advanced ثم المتابعة. هذا متوقع للاستخدام الشخصي، والحد ١٠٠ مستخدم وأنت مستخدم واحد.
  34. **إذا رفضت إحدى مساحات العمل الربط:** مدير تلك المساحة يضيف معرّف العميل إلى قائمة التطبيقات الموثوقة من:
  35. Admin console ← Security ← Access and data control ← API controls ← Manage Third-Party App Access.
  36. ### ٢) توليد الأسرار
  37. ```bash
  38. python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())" # ENCRYPTION_KEY
  39. python3 -c "import secrets; print(secrets.token_urlsafe(32))" # SESSION_SECRET
  40. python3 -c "import secrets; print(secrets.token_urlsafe(24))" # ADMIN_PASSWORD
  41. ```
  42. انسخ `.env.example` إلى `.env` واملأ القيم. **لا ترفع ملف `.env` إلى المستودع أبداً.**
  43. | المتغير | الوصف |
  44. |---|---|
  45. | `PUBLIC_URL` | العنوان العام للخادم بصيغة https، بدون شرطة في آخره |
  46. | `ADMIN_PASSWORD` | كلمة مرور المالك، ١٦ حرفاً على الأقل. يحتفظ بها عبدالرحمن فقط |
  47. | `ENCRYPTION_KEY` | مفتاح تشفير صلاحيات جوجل. **إذا ضاع تضطر لإعادة ربط كل الحسابات** |
  48. | `SESSION_SECRET` | سرّ توقيع جلسة لوحة الإدارة |
  49. | `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` | من الخطوة ١ |
  50. ### ٣) الاستضافة
  51. يحتاج الخادم ثلاثة أشياء:
  52. - عنوان عام بشهادة https.
  53. - **قرص دائم** على المسار `/data`، لأن قاعدة البيانات تُحفظ فيه.
  54. - تشغيل مستمر.
  55. أي مزوّد يشغّل حاويات دوكر مع قرص دائم يكفي: خادم افتراضي خاص مع عاكس وكيل يصدر الشهادة تلقائياً، أو منصة حاويات تدعم الأقراص الدائمة. **لا تستخدم منصة بدون قرص دائم**، فستُمسح الحسابات المربوطة عند كل إعادة تشغيل.
  56. ```bash
  57. docker build -t gmail-mcp .
  58. docker run -d --name gmail-mcp --restart unless-stopped \
  59. --env-file .env -v gmail_mcp_data:/data -p 8000:8000 gmail-mcp
  60. ```
  61. ثم ضع أمامه عاكساً وكيلاً بشهادة https يوجّه النطاق إلى المنفذ 8000.
  62. ### ٤) ربط حسابات البريد (يقوم به المالك)
  63. 1. افتح `https://<عنوان-الخادم>/admin` وادخل بكلمة مرور المالك.
  64. 2. اضغط "ربط حساب جوجل جديد"، واختر الحساب، ووافق على **كل** الصلاحيات.
  65. 3. كرر الخطوة لكل حساب.
  66. 4. لكل حساب، اكتب **اسماً مختصراً** مثل "مكشاتي" أو "ولف باك" لتستخدمه في حديثك مع كلود، و**اسماً ظاهراً** يراه المستلم.
  67. ### ٥) إضافة الموصل في كلود (يقوم به المالك)
  68. 1. في كلود: الإعدادات ← الموصلات ← إضافة موصل مخصص.
  69. 2. الرابط: `https://<عنوان-الخادم>/mcp`، واترك الإعدادات المتقدمة فارغة.
  70. 3. اضغط ربط. تفتح صفحة الخادم، فأدخل كلمة مرور المالك ثم اضغط موافقة.
  71. 4. يعمل الموصل بعدها من الويب والجوال وتطبيق سطح المكتب على نفس الحساب.
  72. **ملاحظة:** في خطة الفريق، المالك هو من يضيف الموصل المخصص على مستوى المؤسسة، ثم يربطه كل عضو بحسابه. لا تشارك كلمة مرور المالك مع أحد، فمن يملكها يصل إلى كل البريد.
  73. ---
  74. ## أمثلة على الاستخدام مع كلود
  75. - "ابحث في كل إيميلاتي عن آخر رسالة من المورد الكوري"
  76. - "اقرأ محادثة فاتورة أودو في حساب شب فور لس"
  77. - "رد من حساب ولف باك على رسالة المورد بأننا نؤكد الطلب" (يعرض كلود الرد عليك أولاً)
  78. ---
  79. ## الصيانة والأمان
  80. - **إذا ظهر عند حساب "يحتاج إعادة ربط":** اضغط "إعادة الربط" بجانبه. يحدث هذا إذا غُيّرت كلمة مرور الحساب أو أُلغيت الصلاحية.
  81. - **إذا شككت في تسرب:** اضغط "إلغاء كل جلسات كلود"، وغيّر `ADMIN_PASSWORD`، ثم أعد تشغيل الخادم وأعد الربط.
  82. - **النسخ الاحتياطي:** احفظ نسخة من قرص `/data` ومن `ENCRYPTION_KEY` في مكانين منفصلين. القاعدة بدون المفتاح لا تُقرأ.
  83. - **محاولات الدخول:** تُقفل محاولات الدخول ١٥ دقيقة بعد ١٠ محاولات خاطئة.
  84. - **محتوى الرسائل:** نص الرسائل الواردة قد يحتوي تعليمات مدسوسة. كلود يعامله كبيانات، ولا يرسل شيئاً بدون موافقتك الصريحة.
  85. ## حدود الإصدار الحالي
  86. - يقرأ المرفقات: PDF (والممسوح ضوئياً يُعرض صوراً)، وورد docx، وإكسل xlsx/xls/csv، وباوربوينت pptx، والصور (منها HEIC)، والنصوص، وملفات zip. الصيغ القديمة doc/ppt/rtf غير مدعومة.
  87. - لا يرسل مرفقات مع الرسائل.
  88. - لا يحذف الرسائل ولا ينقلها ولا يضع عليها تصنيفات، عن قصد.
  89. - يُقتطع نص الرسالة الطويلة جداً عند ١٥ ألف حرف.
  90. ## الاختبار
  91. ```bash
  92. pip install -r requirements.txt
  93. python3 -I tests/test_server.py
  94. ```
  95. الاختبار يحاكي واجهة جيميل ويغطي ٣٣ حالة: المصادقة، ورفض الطلبات غير المصرّح بها، والبحث في كل الحسابات، والقراءة، والإرسال، والرد، والمسودات، ولوحة الإدارة.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.