/ الدليل / الملعب / 1MCP Agent
← كل الخوادم ↗ GitHub
● مجتمع 1mcp-app ⚡ فوري

1MCP Agent

بواسطة 1mcp-app · 1mcp-app/agent

جمّع كل خوادم MCP التي تستخدمها في endpoint واحد — إعداد مشترك ومصادقة مشتركة وأسماء أدوات بفواصل اسمية ومكان واحد لتحديثها جميعاً.

1mcp/agent وكيل توحيد لخوادم MCP. اضبطه مرة واحدة بجميع خوادمك (filesystem, github, postgres, sentry, إلخ)، وعميلك (Claude Desktop / Cursor / Cline) لن يرى سوى خادم MCP واحد. الأدوات تحصل على بوادر اسمية (github__create_issue)، والعامل يتولى التشغيل/فحص الحالة، ويمكنك إعادة تحميل الإعداد دون إعادة تشغيل العميل.

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

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

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

عرض مباشر

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

onemcp-agent.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "onemcp-agent",
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "onemcp-agent": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@1mcp/agent"
        ]
      }
    }
  }
}

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

claude mcp add onemcp-agent -- npx -y @1mcp/agent

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

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

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

توحيد أكثر من 20 خادم MCP خلف endpoint واحد

👤 المستخدمون المتقدمون الذين لديهم خوادم MCPs كثيرة مضبوطة ⏱ ~25 min intermediate

متى تستخدمه: claude_desktop_config.json الخاص بك يحتوي على أكثر من 20 إدخالاً وإضافة/إزالة الخوادم أمر مؤلم.

المتطلبات الأساسية
  • 1mcp مثبت — npx -y @1mcp/agent (أو تثبيت دائم عبر الوثائق)
الخطوات
  1. نقل الخوادم الموجودة إلى إعداد 1mcp
    Use onemcp-agent. Convert my current MCP client config into a 1mcp config file with each server prefixed by its name.✓ تم النسخ
    → 1mcp.config.json مع جميع الخوادم + البوادر
  2. توجيه العميل إلى 1mcp
    Replace my client's MCP config with a single entry pointing at 1mcp; keep a backup.✓ تم النسخ
    → العميل يرى خادماً واحداً؛ الأدوات مدرجة بالبوادر
  3. إضافة خادم جديد ساخناً
    Add the new arxiv MCP to 1mcp config and reload — without restarting Claude Desktop.✓ تم النسخ
    → أدوات جديدة تظهر في تحديث list_tools التالي

النتيجة: مصدر حقيقة واحد لجميع خوادم MCP؛ تكرار أسرع.

المزالق
  • أسماء الأدوات تصبح طويلة بالبادئة — استخدم أسماء مستعارة قصيرة للبادئة لكل خادم (gh, fs, pg) بدلاً من الأسماء الكاملة

تشغيل مجموعة MCP مشتركة للفريق على صندوق تطوير

👤 فرق تطوير صغيرة تستخدم بنية تحتية مشتركة ⏱ ~45 min advanced

متى تستخدمه: تريد أن يشارك الجميع في الفريق نفس خوادم MCP الموثوقة + الأسرار، لا تكرار الإعدادات.

المتطلبات الأساسية
  • مضيف يمكن الوصول إليه — شغّل 1mcp على صندوق تطوير يكشف SSE/HTTP مع مصادقة
الخطوات
  1. مركزة الإعداد
    Configure 1mcp on the dev box with our team's MCP set + shared auth tokens. Expose via authenticated SSE.✓ تم النسخ
    → المجموعة تعمل؛ endpoint SSE يتطلب bearer token
  2. توزيع إعداد عميل واحد
    Generate per-developer client snippets pointing to the shared SSE URL with their personal bearer.✓ تم النسخ
    → مقتطف واحد لكل مطور

النتيجة: الفريق يحصل على مجموعة MCP موثوقة دون أن يدير كل شخص 20 إعداداً.

المزالق
  • مضيف واحد = نقطة فشل واحدة — وثّق الرجوع إلى إعداد محلي؛ أو شغّل نسخاً خلف load balancer

عزل خادم MCP غير موثوق خلف 1mcp

👤 المستخدمون الواعون بالأمان الذين يجربون خوادم المجتمع ⏱ ~30 min advanced

متى تستخدمه: تريد تجربة خادم MCP تابع لجهة خارجية لكن لا تريد منحه وصولاً كاملاً لبيئتك أو نظام ملفاتك.

الخطوات
  1. تشغيل 1mcp في حاوية
    Set up 1mcp in a Docker container with minimal env; mount only ./scratch/. Add the untrusted MCP under a 'sandbox' prefix.✓ تم النسخ
    → الحاوية تعمل؛ فقط أدوات sandbox/ مرئية من MCP المعزول
  2. استخدامه لمهمة واحدة
    Run the experimental task only with sandbox__ tools.✓ تم النسخ
    → المهمة تكتمل؛ لا شيء خرج من الحاوية

النتيجة: تجربة خوادم غير موثوقة دون منحها مفاتيح المملكة.

المزالق
  • نسيان أن MCP لا يزال يستطيع الوصول للشبكة من داخل الحاوية — استخدم --network none أو namespace شبكة مقيّدة إذا كان البث الخارجي مهماً

التركيبات

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

onemcp-agent + filesystem + github

مجمّع لمجموعة خوادمك اليومية

Configure 1mcp with filesystem (prefix fs) + github (prefix gh) + postgres (prefix pg). Use fs__read_file and gh__create_issue from one client.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_servers — فحص الحالة / التصحيح 0
reload_config config_path? بعد تحرير 1mcp.config.json 0
restart_server server_name عندما يتصرف خادم فرعي بشكل خاطئ 0
<prefix>__<tool> as per child tool جميع أدوات الخوادم الفرعية تظهر ببوادرها depends on child server

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

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

حصة API
يضيف حملاً إضافياً ضئيلاً لكل استدعاء
الرموز لكل استدعاء
0 — الوكيل يمرر مباشرةً؛ تكلفة قائمة الأدوات هي مجموع الأطفال
التكلفة المالية
مجاني
نصيحة
عطّل الخوادم الفرعية نادرة الاستخدام عبر علامة إعداد بدلاً من إزالتها — يُبقي system prompt ضئيلاً

الأمان

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

الحد الأدنى من الصلاحيات: ما تحتاجه الخوادم الفرعية
تخزين بيانات الاعتماد: متغيرات بيئة الخوادم الفرعية مركزة في 1mcp.config.json — احمِ هذا الملف
نقل البيانات الخارجي: ما تفعله الخوادم الفرعية — 1mcp نفسه لا يُرسل بياناً خارجياً إلا إذا ضُبط على SSE بعيد
لا تمنح أبدًا: ملف إعداد مقروء من الجميع مع أسرار

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

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

فشل تشغيل خادم فرعي

تحقق من سجلات 1mcp لـ stderr ذلك الخادم؛ عادةً متغير بيئة مفقود أو مسار أمر خاطئ

تحقق: جرّب أمر الطفل بشكل مستقل في terminal
تعارض في اسم الأداة

أضف أو اختصر البوادر لكل خادم في الإعداد

تحقق: list_servers يُظهر البوادر الحالية
إعادة التحميل الساخنة لا تلتقط التغييرات

بعض التغييرات تتطلب إعادة تشغيل (وضع النقل، المنفذ). شغّل restart_server على الطفل المتأثر أو أعد تشغيل 1mcp بالكامل

استجابة أولى بطيئة

الأطفال يُشغَّلون بتهاون افتراضياً — اضبط 'eager: true' للخوادم السريعة

البدائل

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

البديلمتى تستخدمهاالمقايضة
metamcpتريد مجمّعاً مُدار بواجهة مستخدم مع سير عمل فريقأثقل؛ آراء أقوى
mcp-router (TheLunarCompany/lunar)تحتاج حوكمة وسجلات مراجعة (المؤسسات)سطح أكبر؛ إعداد أكثر

المزيد

الموارد

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

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

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