freemcplab / الدليل / الملعب / MCP Apps Protocol

● رسمي modelcontextprotocol ⚡ فوري

MCP Apps Protocol

Name: MCP Apps Protocol MCP Server
Author: modelcontextprotocol

بواسطة modelcontextprotocol · modelcontextprotocol/ext-apps

الامتداد الرسمي الذي يتيح لخوادم MCP شحن مقاطع واجهة مستخدم تفاعلية — يُدرج Claude نموذجك/مخططك/أداة الاختيار مباشرة في المحادثة.

MCP Apps هو امتداد رسمي لـ MCP يتيح للخوادم إعلان واجهات مستخدم تفاعلية (نماذج، مخططات، أدوات اختيار) يُقدّمها مضيف chatbot. يحتوي هذا المستودع على المواصفة وحزمة SDK المرجعية والأمثلة.

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

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

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

مواصفة واجهات مستخدم مضمّنة في MCP
حزمة SDK مرجعية (TypeScript)
تطبيقات مثال
إرشادات تنفيذ المضيف
يُصان من قِبل فريق MCP

عرض مباشر

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

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-apps-protocol",
      "args": []
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-apps-protocol": {
      "command": {
        "args": []
      }
    }
  }
}

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

claude mcp add mcp-apps-protocol -- undefined

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

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

استخدامات عملية: MCP Apps Protocol

إضافة تأكيد قائم على نموذج إلى أداة MCP

👤 المطورون ⏱ ~15 min intermediate

متى تستخدمه: للأداة آثار جانبية تدميرية؛ تريد تأكيداً من المستخدم قبل التنفيذ.

الخطوات

قراءة المواصفة

تصفّح قسم مواصفة Apps.✓ تم النسخ

→ النموذج الذهني
إضافة مقطع واجهة مستخدم

أعد مكوّن App من معالج أداتك.✓ تم النسخ

→ المضيف يعرض النموذج
ربط الإرسال

عند الإرسال، تُستدعى الأداة مجدداً بالمعاملات المؤكدة.✓ تم النسخ

→ أداة تدميرية أكثر أماناً

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

التركيبات

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

mcp-apps-protocol + fastmcp

استخدم fastmcp كخادم MCP؛ Apps للأجزاء التفاعلية

Combine mcp-apps-protocol with fastmcp: Use fastmcp as your MCP server; Apps for interactive bits✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
protocol-spec	(انظر التوثيق)	لا أدوات قابلة للاستدعاء — هذا امتداد بروتوكول	1 استدعاء

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

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

حصة API: لا ينطبق
الرموز لكل استدعاء: 0
التكلفة المالية: مجاني
نصيحة: حافظ على Apps صغيرة — تُعرض مضمّنة

الأمان

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

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: لا شيء

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

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

المضيف لا يعرض الـ App

تأكد أن المضيف يدعم امتداد Apps؛ إنه اختياري

البدائل