/ الدليل / الملعب / arcade-mcp
● مجتمع ArcadeAI ⚡ فوري

arcade-mcp

بواسطة ArcadeAI · ArcadeAI/arcade-mcp

إطار عمل Python لإنشاء ونشر وتشارك خوادم MCP — مع OAuth مدمج وإدارة الأسرار وإعدادات العميل بأمر واحد.

Arcade MCP (ArcadeAI) هو إطار عمل Python يركز على دورة حياة الخادم الكاملة: إنشاء (arcade new)، إضافة أدوات (بما في ذلك التكاملات المحمية بـ OAuth)، والنشر لأي عميل. يختلف عن Golf في التركيز على النشر والتوزيع — يسهل مشاركة الخوادم مع فريقك أو المستخدمين.

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

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

عرض مباشر

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

arcade.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "arcade",
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "arcade": {
      "command": {
        "path": "uvx",
        "args": [
          "arcade-mcp"
        ]
      }
    }
  }
}

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

claude mcp add arcade -- uvx arcade-mcp

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

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

استخدامات عملية: arcade-mcp

إنشاء خادم MCP عامل في أقل من 5 دقائق باستخدام Arcade

👤 أي شخص جديد في تطوير MCP ⏱ ~15 min beginner

متى تستخدمه: لم تبن MCP من قبل ولا تريد توصيل SDK يدويًا.

المتطلبات الأساسية
  • uv — astral.sh/uv
الخطوات
  1. التثبيت + الإنشاء
    شغّل uv tool install arcade-mcp ثم arcade new my_server. افتح المشروع الذي تم إنشاؤه.✓ تم النسخ
    → مشروع يحتوي على أدوات مثالية
  2. التشغيل محليًا
    شغّل uv run server.py واستخدم mcp tools (من f/mcptools) لإدراج ما تم الإعلان عنه.✓ تم النسخ
    → الأدوات الافتراضية مرئية
  3. تكوين Claude Desktop
    شغّل arcade configure claude لربطه.✓ تم النسخ
    → تم تحديث إعدادات Claude Desktop؛ يظهر الخادم عند التشغيل التالي

النتيجة: MCP عامل يمكنك التكرار عليه بدون قراءة مستندات المواصفات.

اجمعها مع: mcptools

بناء أداة MCP تستدعي API محمي بـ OAuth

👤 المطورون الذين يدمجون خدمات SaaS من طرف ثالث ⏱ ~45 min advanced

متى تستخدمه: تحتاج Claude للاستدعاء إلى Reddit/Linear/GitHub نيابة عن المستخدم، وليس خدمتك.

المتطلبات الأساسية
  • تطبيق OAuth مسجل لدى مزود الخدمة المستهدف — وحدة تحكم المطور الخاصة بمزود الخدمة
الخطوات
  1. تكوين OAuth في arcade.yaml
    اضبط Reddit OAuth وفقًا للمثال في README الخاص بـ Arcade.✓ تم النسخ
    → مزود OAuth مسجل
  2. كتابة الأداة
    أضف أداة get_saved_posts تستخدم رمز OAuth المحقون للوصول إلى API Reddit.✓ تم النسخ
    → الأداة تعمل بعد تفويض المستخدم
  3. التشغيل الأول يشغل المصادقة
    استدع get_saved_posts من Claude — يرسل Arcade المستخدم عبر تدفق OAuth مرة واحدة.✓ تم النسخ
    → تم تخزين الرمز؛ الاستدعاءات اللاحقة لا تطلب مرة أخرى

النتيجة: تكاملات MCP محدودة بنطاق المستخدم بدون الاحتفاظ بالبيانات الاعتمادية.

شارك خادم MCP مع فريقك باستخدام Arcade

👤 فرق المنصة / DevEx ⏱ ~20 min intermediate

متى تستخدمه: بنيت MCP داخلي مفيد وتريد للآخرين تثبيته بأمر واحد.

الخطوات
  1. نشر المشروع (سجل داخلي أو git)
    انشر مشروع Arcade الخاص بك إلى pypi داخلي أو إصدار GitHub مميز.✓ تم النسخ
    → أمر التثبيت جاهز
  2. يقوم الزملاء بالتثبيت
    يشغل الزملاء uvx <your-package> و arcade configure claude — تم.✓ تم النسخ
    → يظهر الخادم في عملائهم

النتيجة: تم اعتماد MCP جديد عبر الفريق في دقائق.

التركيبات

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

arcade + mcptools

فحص سطوح الأداة أثناء التطوير

شغّل mcp tools على خادم arcade dev الخاص بي للتحقق من المخطط بعد كل تغيير.✓ تم النسخ
arcade + hyper

قارن Python/Arcade مقابل WASM/hyper للأداة نفسها

نفّذ الأداة نفسها 'fetch_user' في كل من Arcade و hyper-mcp؛ قِس زمن الكمون.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
arcade new <name> project_name: str البدء 0
arcade configure <client> client: claude|cursor|vscode الربط مع عميل 0
arcade dev التكرار المحلي 0

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

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

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

الأمان

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

تخزين بيانات الاعتماد: مخزن الأسرار الخاص بـ Arcade؛ تُحفظ رموز OAuth بشكل منفصل عن الأسرار الثابتة
نقل البيانات الخارجي: أي شيء تستدعيه أدواتك

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

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

أمر arcade غير موجود بعد التثبيت

تأكد من أن مجلد أدوات uv موجود في PATH: export PATH=$HOME/.local/share/uv/tools/bin:$PATH

تحقق: which arcade
حلقة إعادة توجيه OAuth

عدم تطابق عنوان URL رد الاتصال — يجب أن يطابق بالضبط عنوان URL المسجل لدى مزود الخدمة، بما في ذلك الشرطة المائلة الزائدة

مخطط الأداة لم يتم تحديثه في العميل

معظم العملاء يستخدمون التخزين المؤقت؛ أعد تشغيل العميل بعد إضافة/إزالة الأدوات

البدائل

arcade-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Golfتعطي الأولوية لمصادقة Enterprise/التلقائي على راحة التوزيعموجه أكثر نحو الخادم الخلفي
FastMCPMCP بملف واحد، بدون الحاجة إلى OAuthاحضر كل شيء بنفسك بخلاف الأساسي
TS SDK directمتجر TypeScriptلغة مختلفة

المزيد

الموارد

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

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

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