/ الدليل / الملعب / MCP Agent Mail
← كل الخوادم ↗ GitHub
● مجتمع Dicklesworthstone ⚡ فوري

MCP Agent Mail

بواسطة Dicklesworthstone · Dicklesworthstone/mcp_agent_mail

امنح أسطول agents البرمجية بريدًا إلكترونيًا — هويات وصناديق بريد وخيوط محادثة قابلة للبحث وحجوزات ملفات استشارية. أوقف تعارضها مع بعضها.

MCP Agent Mail خادم FastMCP يعمل عبر HTTP فقط، ويمنح كل agent هوية ثابتة وصندوق وارد/صادر وسجل تدقيق مرتبط بتجزئة متسلسلة وحجوزات اختيارية للملفات. مصمم للفرق التي تشغّل عدة نسخ من Claude Code أو Codex أو Gemini CLI على نفس monorepo، إذ يضيف طبقة التنسيق المفقودة حين تحاول 3 agents إعادة هيكلة الملف ذاته في وقت متأخر من الليل.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

mcp-agent-mail.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-agent-mail",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-agent-mail": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://127.0.0.1:8765/mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add mcp-agent-mail -- npx -y mcp-remote http://127.0.0.1:8765/mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: MCP Agent Mail

تنسيق 3 جلسات Claude Code على نفس monorepo دون فوضى الدمج

👤 الفرق التي تشغّل جلسات agents متوازية ⏱ ~30 min intermediate

متى تستخدمه: حين تُشغّل agents لكل فرع ميزة وتستمر في الاستيلاء على الملفات ذاتها.

المتطلبات الأساسية
  • مضيف Docker يمكن الوصول إليه من كل agent — docker compose up --build يعرض المنفذ :8765
  • هوية فريدة لكل agent — الاستدعاء الأول لـ whoami يُسجّل الهوية؛ ثبّتها في CLAUDE.md
الخطوات
  1. التعريف بالهوية
    Use mcp-agent-mail. Register me as claude-feature-auth and list active leases.✓ تم النسخ
    → الهوية محفوظة؛ قائمة الحجوزات مُعادة
  2. حجز الملفات قبل التعديل
    Before editing src/auth/*, take a 30-min lease and announce intent in the #refactor thread.✓ تم النسخ
    → الحجز ممنوح؛ الرسالة مرئية للـ agents الأخرى
  3. تسليم العمل
    Done with the auth module. Release leases, post a summary to #refactor with the diff range.✓ تم النسخ
    → الحجز محرر؛ الخيط محدَّث

النتيجة: ثلاثة agents تُنهي عملًا متوازيًا على نفس المستودع دون الكتابة فوق تعديلات بعضها.

المزالق
  • الحجوزات استشارية — يمكن للـ agents تجاهلها — أضف قاعدة في CLAUDE.md: 'تحقق دائمًا من الحجوزات قبل التعديل، وأعلن النية أولًا'
اجمعها مع: filesystem · github

تسليم العمل بين agents تعمل على مستودعات مترابطة

👤 المطورون الذين يديرون agents للواجهة الأمامية والخلفية ⏱ ~20 min intermediate

متى تستخدمه: حين ينهي agent الخلفية تعديلًا على API ويحتاج agent الواجهة الأمامية للتكيّف معه.

الخطوات
  1. الإرسال
    From claude-backend: send claude-frontend a message titled 'New /v2/orders schema' with the OpenAPI diff.✓ تم النسخ
    → الرسالة أُرسلت؛ عداد صندوق الوارد لـ agent الواجهة الأمامية يرتفع
  2. الاستقبال
    From claude-frontend: read inbox, summarize new messages, propose component updates.✓ تم النسخ
    → agent الواجهة الأمامية يُقرّ بالتغيير ويبدأ العمل

النتيجة: تسليم غير متزامن بين الـ agents دون نسخ ولصق prompts يدويًا.

المزالق
  • ارتباك في الهوية عبر الأجهزة — اربط الهوية باسم المضيف أو استخدم لاحقة عشوائية طويلة

الحصول على سجل تحليلي جنائي لكل رسالة agent وحجز

👤 فرق العمليات / تشخيص أخطاء الـ agents ⏱ ~15 min intermediate

متى تستخدمه: حين يفعل أحد الـ agents شيئًا غريبًا في الساعة الثالثة صباحًا وتحتاج لإعادة بناء سلسلة الأحداث.

الخطوات
  1. البحث
    Search messages between 02:00 and 04:00 mentioning 'database migration'.✓ تم النسخ
    → إدخالات مُعادة مرتبطة بتجزئة
  2. التحقق من السلسلة
    Verify the audit chain hasn't been tampered.✓ تم النسخ
    → السلسلة سليمة؛ فحص التلاعب نظيف

النتيجة: سجل قابل للاحتجاج به لاتصالات الـ agents في تقارير ما بعد الحوادث.

المزالق
  • تنمو قاعدة البيانات بلا حدود — جدوِل تقليص الاحتفاظ؛ أرشف إلى S3 شهريًا
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

mcp-agent-mail + filesystem

نظام انضباط الحجز-ثم-التعديل للـ agents المتوازية

Before any filesystem.write, claim a lease via mcp-agent-mail.✓ تم النسخ
mcp-agent-mail + github

نشر إشعارات PR إلى خيط تشترك فيه الـ agents الأخرى

When my PR merges, post to #merged with the SHA and changed paths.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
whoami (none) الاستدعاء الأول من أي agent free
send_message to, subject, body, thread? تسليم العمل إلى agent آخر free
read_inbox since?, limit? بداية الجلسة — لمعرفة ما هو في قائمة الانتظار free
claim_lease path, ttl_min, reason قبل تعديل ملف قد تلمسه agents أخرى free
release_lease lease_id بعد الcommit / عند الانتهاء free
search_messages query, from?, to? التحليل الجنائي أو إعادة اكتشاف السياق free

التكلفة والحدود

تكلفة التشغيل

حصة API
مستضاف ذاتيًا؛ مقيّد بأجهزتك
الرموز لكل استدعاء
ضئيل — ~50–200 token زيادة لكل استدعاء تنسيق
التكلفة المالية
مجاني (MIT)
نصيحة
التشغيل رخيص؛ التكلفة الحقيقية هي استدعاءات الـ agent التي توفرها بعدم تكرار العمل

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Network access between agent host and mail server
تخزين بيانات الاعتماد: token اختياري لحامل الهوية في متغير البيئة
نقل البيانات الخارجي: يبقى على بنيتك التحتية — لا استدعاءات لأطراف ثالثة
لا تمنح أبدًا: Public exposure without TLS + auth

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Connection refused on :8765

تحقق من تشغيل حاوية Docker وتوجيه المنفذ؛ راجع docker ps

تحقق: curl http://127.0.0.1:8765/health
Identity collision

أضف لاحقة عشوائية أو اربط باسم المضيف

Lease taken by stale agent

الحجوزات تنتهي تلقائيًا بـ TTL؛ قلل الـ TTL الافتراضي أو استخدم أداة admin للإفراج القسري

البدائل

MCP Agent Mail مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Plain shared CLAUDE.mdagent واحد أو اثنان بحد أقصى، تزامن منخفضلا حالة — يعتمد على قراءة الـ agents للملف ذاته
Git branches per agentتريد عزلًا صارمًاتكلفة الدمج ترتفع؛ لا إشارات في الوقت الحقيقي

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills