خادم Replicate MCP: شغّل النماذج من Claude و Claude Code و Cursor

يمكنك الآن أن تطلب من Claude العثور على نموذج صور على Replicate، وتشغيله بأمرك النصي، وإعادة الملف الجاهز دون مغادرة المحادثة. هذا هو الغرض الكامل من خادم Replicate MCP. فهو يربط واجهة Replicate HTTP API بأي عميل يتحدث بروتوكول سياق النموذج (Model Context Protocol)، حتى تتمكن Claude Desktop و Claude Code و Cursor من البحث في آلاف النماذج وإنشاء التوقعات نيابةً عنك.

يستغرق الإعداد نحو خمس دقائق. ما يبطئ الناس عادةً هي التفاصيل الصغيرة: أي عنوان URL تلصق، وأي وسيلة نقل تختار، وأين يُوضع الرمز المميز، وما يظهر في الفاتورة لاحقًا. ستجد فيما يلي الأوامر الدقيقة لكل عميل، وقائمة تحقق لسلامة الرمز المميز، ونظرة على وضع الشيفرة التجريبي، ومسارًا بلا إعداد لمن يريد الصور والفيديوهات الجاهزة فقط.

ماذا يفعل خادم Replicate MCP

تستضيف Replicate فهرسًا كبيرًا من نماذج الصور والفيديو والصوت والنص خلف واجهة API واحدة. ويغلّف خادم MCP الرسمي هذه الواجهة API كأدوات، بحيث يمكن للمساعد استدعاؤها مباشرةً بدلًا من أن تتنقل بين أوامر curl ونوافذ المتصفح. بحسب وثائق Replicate، يدعم كل العمليات الموجودة في Replicate HTTP API: البحث عن النماذج وعرضها وفحصها، ثم إنشاء التوقعات وجلبها.

كيف يتحول الأمر النصي إلى توقع

لنفترض أنك كتبت: اصنع صورة بنسبة 16:9 لمنارة عند الفجر. يمرّر العميل رسالتك إلى النموذج اللغوي، فيقرر النموذج أنه يحتاج إلى أداة للصور فيستدعي الخادم. يمرر الخادم الطلب إلى Replicate، فيشغّل النموذج المختار على وحدات GPU الخاصة بها ويعيد رابط الناتج. عادةً يبدو التسلسل كالتالي:

1. يبحث المساعد عن نموذج يناسب المهمة.
2. يقرأ خيارات الإدخال لذلك النموذج، مثل حقل الأمر النصي ونسبة العرض إلى الارتفاع.
3. ينشئ توقعًا بأمرك النصي وإعداداتك.
4. يجلب النتيجة ويعرض عليك رابط الناتج.

💡 نصيحة: إذا كنت تعرف النموذج الذي تريده، فاذكره في الأمر النصي. هذا يتجاوز خطوة البحث ويجعل النتائج قابلة للتكرار من جلسة إلى أخرى.

تنطبق الحلقة نفسها على نماذج الفيديو والصوت. اطلب مقطعًا مدته خمس ثوانٍ، وسيختار المساعد نموذج فيديو، ويملأ حقل المدة، ثم يستعلم عن الحالة حتى تنتهي المهمة. تستغرق مهام الفيديو وقتًا أطول من الصور، لذا توقع انتظارًا لدقيقة أو أكثر بدل بضع ثوانٍ.

الأدوات التي ستحصل عليها

تسمّي صفحة Replicate لخادم MCP ثلاث أدوات، وتسرد الوثائق العمليات الأساسية:

العتاد مهم لأنه يحدد السرعة والسعر معًا، لذلك تستحق list_hardware التجربة قبل دفعة كبيرة.

الإعداد المستضاف أو المحلي

يمكنك تشغيل الخادم بطريقتين، والاختيار بينهما يحدد طريقة المصادقة.

اختر الخادم المستضاف ما لم يكن لديك سبب لتشغيل عملية على جهازك. يلغي هذا الخيار ملف الرمز المميز من إعدادك كليًا، وهو المسار الذي تبدأ به كل الأمثلة في الأقسام التالية.

⚠️ تنبيه: تطلب منك بعض الدروس القديمة تثبيت mcp-replicate. كانت تلك تجربة من المجتمع، وتقول ملاحظاتها إنها لم تعد قيد التطوير النشط. حلّ الخادم الرسمي محلها، فتجاهل الحزمة القديمة.

الخادم المستضاف على mcp.replicate.com

الخادم المستضاف هو ما توصي به Replicate. يتصل العملاء بنقطة SSE، وهي https://mcp.replicate.com/sse، وتنتهي بخطوة موافقة عبر الويب تلصق فيها رمز API من Replicate. أنشئ الرمز من replicate.com/account/api-tokens قبل أن تبدأ، واحتفظ به في الحافظة.

الخادم المحلي باستخدام npx

يشغّل الخيار المحلي الخادم نفسه كعملية على جهازك. اضبط REPLICATE_API_TOKEN، وشغّله باستخدام npx -y replicate-mcp، وأوقفه بالضغط على Ctrl+C. تشغّله معظم العملاء نيابةً عنك من ملف إعداد كهذا:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "replicate-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "your-token-here"
      }
    }
  }
}

نسخ الأمر النصي

يقرأ VS Code مع GitHub Copilot الملف .vscode/mcp.json، ويستخدم كائن servers على المستوى الأعلى بدل mcpServers، لذا انسخ الكتلة وأعد تسمية هذا الحقل فقط. إذا لم يظهر الخادم أبدًا، فتأكد من تثبيت Node ومن أن npx يعمل من نافذة طرفية عادية.

الربط مع Claude Desktop

يُعد Claude Desktop أسرع طريق، لأن الخادم المستضاف لا يحتاج إلى أي ملف إعداد.

إضافة الموصل المخصص

1. افتح Settings وانتقل إلى Connectors.
2. انقر على Add Custom Connector.
3. أدخل عنوان URL للخادم: https://mcp.replicate.com/sse.
4. انقر على Connect والصق رمز API من Replicate.
5. انقر على Log in and Approve.
6. أعد تشغيل Claude Desktop. ستظهر الأدوات تحت أيقونة المنزلقات أسفل حقل الدردشة.

تفضّل الخادم المحلي؟ ضع ملف JSON من القسم السابق في claude_desktop_config.json ثم أعد تشغيل التطبيق.

أول أمر نصي للتجربة

ابدأ بشيء يفرض الحلقة الكاملة من البحث والفحص والتشغيل:

ابحث في Replicate عن نموذج سريع لتحويل النص إلى صورة واقعية كالصور الفوتوغرافية، واعرض لي خيارات الإدخال الخاصة به، ثم ولّد صورة بنسبة 16:9 لمنارة عند الفجر.

تُعد إصدارات FLUX السريعة مثل FLUX Schnell خيارات مرشّحة شائعة لطلب كهذا، لكن البحث هو ما يحدد ما يظهر أولًا. إذا وصلت الإجابة كرابط بدل صورة مضمّنة، فهذا أمر طبيعي: يعيد الخادم عنوان URL للناتج، والعميل هو من يقرر طريقة عرضه.

بعد أن ينجح ذلك، كن أكثر تحديدًا. سمِّ نسبة العرض، والعدسة، واتجاه الضوء، وعدد التنويعات التي تريدها. الأوامر الغامضة تهدر التشغيلات، وكل تشغيل يُحتسب.

الربط مع Claude Code

يحتاج Claude Code إلى أمر واحد، ويحتفظ بالاتصال عبر المشاريع.

التثبيت بأمر واحد

ثبّت واجهة الأوامر CLI إن لم تكن لديك، ثم أضف الخادم:

npm install -g @anthropic-ai/claude-code
claude mcp add replicate https://mcp.replicate.com/sse --transport sse --scope user

نسخ الأمر النصي

يخزّن العلم --scope user الخادم في إعدادات المستخدم لديك، فيحصل كل مشروع تفتحه على حق الوصول إليه.

المصادقة عبر /mcp

شغّل claude، واكتب /mcp، واختر مدخل Replicate، وسيفتح المتصفح مسار الموافقة نفسه الذي يستخدمه Claude Desktop. عندما يُظهر أنه متصل، اطلب تشغيلًا بلغة عادية.

بما أن Claude Code يعمل داخل مستودعك، فيمكنه أكثر من عرض رابط. جرّب هذا: ولّد ثلاثة خيارات لصورة البطل في صفحة الهبوط، ثم نزّل كل ناتج إلى public/images. خطوة التنزيل أهم مما تبدو، ويشرح قسم التكاليف أدناه السبب.

إذا لم تظهر الأدوات، فشغّل /mcp مرة أخرى وتحقق من سطر الحالة الخاص بالخادم. الخادم الذي يظهر كغير متصل يحتاج عادةً إلى مصادقة جديدة وليس إلى إعادة تثبيت.

الربط مع Cursor

يقرأ Cursor خوادم MCP من ملف JSON، لذا لا يحتاج هذا الإعداد إلا إلى بضعة أسطر في ملف الإعداد.

تحرير ملف mcp.json

افتح Cursor Settings، وانتقل إلى Tools & Integrations، وانقر على New MCP Server. سيفتح Cursor الملف ~/.cursor/mcp.json، حيث تضيف الخادم المستضاف عبر جسر mcp-remote:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.replicate.com/sse"]
    }
  }
}

نسخ الأمر النصي

لمستودع واحد، أنشئ .cursor/mcp.json داخل المشروع بدلًا من ذلك، واستخدم JSON الخادم المحلي الوارد سابقًا مع وضع رمزك في env. احفظ الملف، ومن المفترض أن يظهر الخادم في لوحة الإعدادات نفسها مع أدواته.

ومن هناك يستطيع وكيل Cursor توليد صور مؤقتة أو لقطات منتجات أو أيقونات أثناء تعديل المكوّن الذي يحتاجها. هذه هي الفائدة الحقيقية: يصل الأصل وتغيير الشيفرة في محادثة واحدة.

عملاء آخرون يعملون مع الخادم

يعمل الخادم نفسه خارج هؤلاء العملاء الثلاثة:

• Claude.ai في المتصفح
• Codex CLI
• Google Gemini CLI
• Windsurf
• Chorus
• VS Code مع GitHub Copilot، باستخدام .vscode/mcp.json

لا يتغير النمط أبدًا: وجّه العميل إلى عنوان URL المستضاف، أو شغّل replicate-mcp محليًا، ثم صادق مرة واحدة.

الرموز المميزة والتكاليف ووضع الشيفرة

ثلاثة أمور تحدد ما إذا كان هذا الإعداد سيبقى مريحًا: كيف تتعامل مع الرمز المميز، وما تكلفه كل عملية تشغيل، وإلى أي حد تدفع الأتمتة.

احمِ رمزك المميز

• أنشئ الرمز من replicate.com/account/api-tokens وعامله كما تعامل كلمة المرور.
• فضّل المسار المستضاف كلما أمكن. يمر الرمز عبر شاشة الموافقة بدل أن يبقى في ملف داخل مستودعك.
• مع الخادم المحلي، احتفظ بالرمز في متغير بيئة، أو أبقِ ملف الإعداد خارج نظام التحكم بالإصدارات. أضف .cursor/mcp.json أو .vscode/mcp.json إلى .gitignore كلما احتوت على رمز.
• أعد توليد الرمز فورًا إذا ظهر في commit أو لقطة شاشة أو محادثة مشتركة.

ما الذي تدفعه

خادم MCP هو بوابة تقود إلى API نفسها، لذلك تُحتسب كل التوقعات على حسابك في Replicate مثل أي استدعاء API آخر. يعتمد السعر على النموذج والعتاد الذي يعمل عليه، ولهذا يُفيد list_hardware ونظرة سريعة على صفحات النماذج قبل أي دفعة كبيرة.

عادة بسيطة تُبقي الفاتورة متوقعة. ابدأ المسودة بنموذج سريع ورخيص مثل FLUX Schnell، وولّد أربعة خيارات، واختر أفضل تكوين، ثم أعد تشغيل الأمر النصي المختار فقط على نموذج أعلى جودة. أخبر المساعد بهذه القاعدة مرة واحدة في بداية الجلسة، وسيلتزم بها في كل طلب بعدها.

💡 نصيحة: تختفي عناوين URL لنواتج توقعات API بعد نحو ساعة. اطلب من المساعد تنزيل كل ناتج أو رفعه فورًا، خاصة في الجلسات الطويلة.

وضع الشيفرة في بيئة معزولة

تقدم Replicate أيضًا وضع شيفرة تجريبيًا. فبدلًا من استدعاء أداة واحدة في كل مرة، يكتب النموذج TypeScript ويشغّلها داخل بيئة معزولة من Deno. ويناسب ذلك المهام التي تربط عدة توقعات ببعضها، مثل توليد ست تنويعات والاحتفاظ بأفضل اثنتين. يحتاج هذا الوضع إلى تثبيت Deno. أضفه إلى Claude Code بالأمر التالي:

claude mcp add "replicate-code-mode" --scope user --transport stdio -- npx -y replicate-mcp@alpha --tools=code

نسخ الأمر النصي

تخبرك العلامة @alpha بما تتوقعه. تعامل معه كبيئة تجريبية، وأبقِ الخادم العادي مثبتًا بجانبه، وراجع مخرجاته قبل أن تعتمد عليه في العمل الإنتاجي.

بديل بلا إعداد على PicassoIA

إذا كنت تريد الصورة أو المقطع الجاهز فقط دون قضاء فترة بعد الظهر في الإعدادات، فإن PicassoIA يتيح مئات النماذج في صفحات قابلة للتصفح دون الحاجة إلى لصق أي رمز. ادمجه مع نموذج لغوي مثل Claude Sonnet 5 لصياغة الأوامر النصية، ثم وَلِّد في المتصفح.

كيفية استخدام PicassoIA Image

PicassoIA Image هو نموذج تحويل النص إلى صورة الخاص بالمنصة، وهو مكان سريع لاختبار أمر نصي قبل أن تؤتمت أي شيء.

1. افتح صفحة نموذج PicassoIA Image.
2. اكتب أمرًا نصيًا يتضمن الموضوع والمكان واتجاه الضوء والعدسة، مثلًا منارة عند الفجر، بزاوية منخفضة، ضوء ذهبي ناعم من اليسار، عدسة 35 ملم، حبيبات فيلم.
3. اختر نسبة العرض إلى الارتفاع التي تحتاجها، مثل 16:9 لترويسات المدونات.
4. ولّد الصورة، وراجع النتيجة، وعدّل تفصيلًا واحدًا في كل مرة.
5. أرسل الصورة الفائزة إلى PicassoIA Image Editor Pro لإجراء تعديلات مثل استبدال عنصر أو إصلاح تفصيلة.
6. حرّكها باستخدام PicassoIA Video، الذي يقبل النص أو الصورة، أو جرّب Seedance 2.5 Lite لمقاطع تصل إلى 10 ثوانٍ.

💡 نصيحة: غيّر متغيرًا واحدًا في كل تشغيل. عندما تتحسن النتيجة، ستعرف أي تعديل أحدث الفرق.

PicassoIA API و MCP

يوفّر PicassoIA أيضًا واجهة REST API على نمط Replicate، لذا ستبدو لك خطوات الإنشاء والاستطلاع والجلب التي أعددتها للتو مألوفة:

• عنوان URL الأساسي: https://api.picassoia.com/v1، مع المصادقة برمز Bearer من حسابك
• إنشاء تشغيل: POST /v1/models/{owner}/{name}/predictions
• فحص تشغيل: GET /v1/predictions/{id}
• إلغاء تشغيل: POST /v1/predictions/{id}/cancel

تتوفر أربعة نماذج عبر واجهة API واتصال MCP: PicassoIA Image، وPicassoIA Image Editor Pro، وPicassoIA Video، وSeedance 2.5 Lite. يحصل كل حساب على 5 توقعات متزامنة مشتركة بين الرموز واتصالات MCP، ويمكن أن تصل الأوامر النصية إلى 4,000 حرف. يعتمد الوصول إلى API وMCP على خطتك، لذا تحقق من صفحة الأسعار قبل أن تبني عليه، واقرأ الوثائق على picassoia.com/en/api.

أنشئ أول صورة لك اليوم

اختر المسار الذي يناسب يومك. إذا كنت تعمل في الطرفية أو المحرر، فاربط خادم Replicate MCP بالأمر المخصص لعميلك، ثم شغّل أمر المنارة. إذا أردت نتيجة خلال الستين ثانية القادمة، فافتح Picasso IA وجرّب الأمر نفسه هناك. شغّل الاثنين، وقارن النتائج، واحتفظ بما يناسب سير عملك، أو استخدم كلًا منهما فيما يجيد.

ثلاثة أوامر نصية لتجربتها على PicassoIA Image، كل منها قصير بما يكفي للصقه:

• قارب صيد عند شروق الشمس، بزاوية منخفضة، ملمس خشب مبلل، عدسة 35 ملم، ضباب ناعم، حبيبات فيلم
• رف استوديو للفخار في ضوء نافذة الصباح، عدسة 85 ملم، عمق ميدان ضحل
• راكب دراجة يعبر جسرًا حجريًا عند الغسق، منظر جوي، ضوء دافئ، ضبابية حركة خفيفة

تصفح كل النماذج، من مولدات الصور والفيديو إلى النماذج اللغوية، على picassoia.com/en/all-models، وابدأ في إنشاء صورك الخاصة على Picasso IA اليوم.