Hub documentation

مساحات كخوادم MCP

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

مساحات كخوادم MCP

يمكنك تحويل أي مساحة عامة تحتوي على شارة MCP ظاهرة إلى أداة قابلة للاستدعاء ستكون متاحة في أي عميل متوافق مع MCP، حيث يمكنك إضافة عدد غير محدود من المساحات دون كتابة سطر برمجي واحد.

إعداد عميل MCP

من إعدادات Hub MCP الخاصة بك، اختر عميل MCP (VSCode أو Cursor أو Claude Code أو غير ذلك) ثم اتبع تعليمات الإعداد.

image/png

تحتاج إلى رمز Hugging Face صالح مع صلاحيات READ لاستخدام أدوات MCP. إذا لم يكن لديك رمز، أنشئ رمز وصول "Read" جديدًا هنا.

إضافة مساحة موجودة إلى أدوات MCP الخاصة بك

image/png

  1. تصفّح Spaces المتوافقة للعثور على Spaces التي يمكن استخدامها عبر MCP. كما يمكنك البحث عن شارة MCP الرمادية على أي بطاقة Spaces.
  2. انقر على الشارة واختر Add to MCP tools ثم أكّد عند الطلب.
  3. يجب أن يُدرج المساحة في إعدادات خادم MCP الخاص بك ضمن قسم أدوات المساحات.

image/png

استخدام Spaces من عميل MCP الخاص بك

إذا كان عميل MCP الخاص بك مُهيأً بشكل صحيح، فستكون المساحات (Spaces) التي أضفتها متاحة فوراً دون الحاجة إلى تغيير أي شيء (إذا لم يُعد تشغيل العميل، فيجب أن تظهر). ستقوم معظم عملاء MCP بعرض قائمة بالأدوات المحمّلة حالياً حتى تتمكن من التأكد من توفر المساحة.

في مساحات ZeroGPU، سيتم استخدام حصتك عند استدعاء الأداة، وإذا نفدت حصتك يمكنك الاشتراك في PRO للحصول على 40 دقيقة من الحصة اليومية (حصة أكبر بثمانية أضعاف من مستخدمي النسخة المجانية). على سبيل المثال، يتيح لك حساب PRO توليد ما يصل إلى 600 صورة يوميًا باستخدام FLUX.1-schnell.

Build your own MCP-compatible Gradio Space

لإنشاء مساحة خاصة بك تدعم MCP، عليك إنشاء مساحة Gradio جديدة ثم التأكد من تفعيل دعم MCP في الكود. ابدأ مع مساحات Gradio وتأكد من الاطلاع على دليل MCP المفصّل لمزيد من التفاصيل.

أولاً، ثبّت Gradio مع دعم MCP:

pip install "gradio[mcp]"

ثم أنشئ تطبيقك مع تلميحات أنواع واضحة وسلاسل توثيق:

import gradio as gr

def letter_counter(word: str, letter: str) -> int:
    """Count occurrences of a letter in a word.
    
    Args:
        word: The word to search in
        letter: The letter to count
        
    Returns:
        Number of times the letter appears in the word
    """
    return word.lower().count(letter.lower())

demo = gr.Interface(fn=letter_counter,
                    inputs=["text", "text"],
                    outputs="number")
demo.launch(mcp_server=True)   # exposes an MCP schema automatically

ادفع التطبيق إلى Gradio Space وسيحصل تلقائيًا على شارة MCP. يمكن لأي شخص بعد ذلك إضافته كأداة بنقرة واحدة.

كما أنه من السهل للغاية تحويل مساحة Gradio موجودة مسبقًا إلى خادم MCP. انسخها من قائمة السياق ثم أضف ببساطة معامل mcp_server=True إلى دالة launch() الخاصة بك، وتأكد من أن دوالك تحتوي على تلميحات أنواع واضحة وسلاسل توثيق - يمكنك استخدام أدوات الذكاء الاصطناعي لأتمتة ذلك بسهولة (مثال على سلاسل توثيق مولّدة بالذكاء الاصطناعي).

كن مبدعاً من خلال دمج المساحات!

بما أن Hugging Face Spaces هو أكبر دليل لتطبيقات الذكاء الاصطناعي، يمكنك العثور على العديد من الأدوات الإبداعية التي يمكن استخدامها كأدوات MCP. إن الجمع بين مساحات مختلفة يمكن أن يؤدي إلى سير عمل قوية وإبداعية.

يُظهر هذا الفيديو استخدام Lightricks/ltx-video-distilled و ResembleAI/Chatterbox في Claude Code لتوليد فيديو مع صوت.
Update on GitHub