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

agent

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

نقطة نهاية MCP موحدة مع OAuth 2.1 وإعادة تحميل فوري وتسجيل التدقيق — بوابة أمامية موجهة للإنتاج تربط عدة خوادم مصب.

1mcp/agent هو محمع MCP مبني على Node/TS. بخلاف الوكلاء البسيطة، يجلب معه OAuth 2.1 القائم على الأنطاق، وإعادة تحميل الإعدادات الفورية، وتعقيم المدخلات، وتسجيل التدقيق، ونقاط فحص الصحة — ميزات ستضطر لإضافتها بنفسك مع nginx و Caddy و cron.

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

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

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

عرض مباشر

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

agent.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent": {
      "command": "npx",
      "args": [
        "-y",
        "agent"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent": {
      "command": "npx",
      "args": [
        "-y",
        "agent"
      ],
      "_inferred": true
    }
  }
}

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

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

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

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

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

claude mcp add agent -- npx -y agent

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

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

استخدامات عملية: agent

تشغيل بوابة MCP متعددة المستأجرين لفرق مختلفة

👤 فرق البنية الأساسية التي تخدم عدة فرق لها احتياجات أداة مختلفة ⏱ ~45 min advanced

متى تستخدمه: فريق التصميم والهندسة يحتاجان MCPs مختلفة، لكن لا تريد تشغيل بوابتين.

المتطلبات الأساسية
  • مضيف يحتوي على Node 20+ أو Docker — أي VM صغير
  • OAuth IdP (أو استخدم المدمج للعميل المحلي) — Dex أو Auth0 أو Okta — أي شيء يتحدث OIDC
الخطوات
  1. حدد الأنطاق في إعدادات الوكيل
    صغ إعدادات وكيل حيث يفضح نطاق 'design' MCPs الخاصة بـ figma و davinci-resolve و نطاق 'eng' يفضح github و sentry و postgres.✓ تم النسخ
    → إعدادات تضم خرائط الخوادم المصب
  2. أضف OAuth
    ربط الوكيل بمستأجر Auth0، احصل على المجموعات إلى الأنطاق.✓ تم النسخ
    → المستخدمون يرون فقط أدوات نطاقهم
  3. تدقيق الاستخدام
    أظهر لي استدعاءات الأداة في آخر 24 ساعة حسب المستخدم، مجمعة حسب اسم الأداة.✓ تم النسخ
    → تقرير الاستخدام

النتيجة: بوابة واحدة، وجهات نظر أداة لكل فريق، سجل تدقيق كامل.

المزالق
  • تصميم الأنطاق يصبح معقداً بسرعة — ابدأ بـ 2-3 أنطاق واسعة (eng-read و eng-write و design) بدلاً من نطاق لكل أداة
  • سجلات التدقيق تملأ مساحة القرص — أدر السجلات أسبوعياً أو أرسلها إلى محمع سجلات
اجمعها مع: github · sentry

تطوير MCP مخصص مع إعادة تحميل فوري

👤 المطورون الذين يكررون على خادم MCP الخاص بهم ⏱ ~20 min intermediate

متى تستخدمه: تكتب MCP جديد ولا تريد إعادة تحميل IDE بعد كل تغيير.

الخطوات
  1. سجل dev MCP تحت الوكيل
    أضف dev MCP المحلي في node ./my-mcp/dist/index.js تحت إعدادات الوكيل، ضع له وسم 'dev'.✓ تم النسخ
    → الأداة تظهر في العميل
  2. عدّل وحفظ وأعد المحاولة
    غيّرت الأداة. أخبرني إذا كانت النسخة الجديدة مباشرة دون إعادة تشغيل.✓ تم النسخ
    → تأكيد إعادة التحميل الفوري

النتيجة: حلقة تطوير سريعة لـ MCP.

المزالق
  • إعادة التحميل الفوري قد تسرب معالجات الأداة القديمة إذا كانت العملاء تخزن مؤقتاً — للتغييرات الواجهة الكبيرة، أعد تحميل العميل على أي حال

حماية خادم MCP غير الموثوق به بالتعقيم

👤 مسؤولو الأمان يشغلون MCPs من المجتمع ⏱ ~15 min intermediate

متى تستخدمه: تريد تجربة MCP من المجتمع لكن تريد حماية إضافية للمدخلات.

الخطوات
  1. فعّل التعقيم
    اضبط وكيل 1mcp لتفعيل تعقيم المدخلات على الخادم 'community-x' وحظر أي أداة ترسل حمولة كبيرة جداً.✓ تم النسخ
    → تم تطبيق الحدود
  2. تحقق
    استدعِ أداة من هذا الخادم وتأكد من دخول سجل التعقيم.✓ تم النسخ
    → السجل يظهر استدعاء معقم

النتيجة: نطاق انفجار أكثر أماناً عند التجريب مع أدوات المجتمع.

التركيبات

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

agent + proxy-2

قارن 1mcp/agent الغني بالميزات مع tbxark/mcp-proxy البسيط

شغّل كلاً من 1mcp/agent و tbxark/mcp-proxy على نفس المضيف وقارن زمن كمون استدعاء الأداة من خلال كل واحد.✓ تم النسخ
agent + jetski

ضع التحليلات فوق 1mcp

شغّل 1mcp/agent خلف Jetski للحصول على OAuth وتحليلات على مستوى الموجه.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_tools (none) المصافحة — معالجتها من قبل العملاء free
call_tool name, args أي استدعاء 1 upstream call
mcp_add name, command, args أضف خادم مصب جديد ديناميكياً (يقتصر على المسؤول) free

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

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

حصة API
لا شيء خاص به؛ يحده حد نطاقات الخوادم المصب
الرموز لكل استدعاء
عبء عمل صغير للوكيل
التكلفة المالية
مجاني و MIT
نصيحة
فعّل التدقيق فقط على الخوادم المصب القادرة على الكتابة — السجلات للقراءة فقط تملأ القرص بسرعة بلا فائدة.

الأمان

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

الحد الأدنى من الصلاحيات: إعدادات OAuth و بيانات اعتماد خادم الخادم المصب
تخزين بيانات الاعتماد: متغيرات البيئة وملف الإعدادات؛ استخدم مدير الأسرار للإنتاج
نقل البيانات الخارجي: الوكيل ينقل إلى الخوادم المصب المكونة فقط
لا تمنح أبدًا: نطاق admin للمستخدمين النهائيين — احتفظ به لفريق البنية الأساسية

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

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

إعادة التحميل الفوري لم تنتقِ تغيير الإعدادات

تحقق من أن مراقب الملف له إذن على الدليل المثبت (Docker bind mounts على macOS قد تفقد الأحداث). عد إلى SIGHUP.

تحقق: docker exec agent kill -HUP 1
رفض رمز OAuth

لا يعين مطلب الأنطاق إلى أي نطاق مكون. تحقق من سجلات الوكيل للمطلب ووازن الإعدادات.

تحقق: فك تشفير JWT على jwt.io
خادم MCP المصب يفشل في فحص الصحة

شغّل أمر الخادم المصب يدويا لترى stderr. سجلات الوكيل تقرر فقط رمز الخروج.

تحقق: docker exec agent sh -c '<upstream command>'
قائمة الأداة فارغة للمستخدم

أنطاق المستخدم لا تطابق أي وسم أداة مطلوب.

تحقق: تحقق من خريطة الأنطاق في الإعدادات مقابل مطالبات JWT

البدائل

agent مقابل البدائل

البديلمتى تستخدمهاالمقايضة
tbxark/mcp-proxyتريد ملف ثنائي Go بسيط بدون OAuthلا مصادقة و لا إعادة تحميل فوري و لا أنطاق
Jetskiتريد لوحات معلومات تحليلية كاملة و DCRبنية K8s + Postgres مطلوبة

المزيد

الموارد

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

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

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