توليد الصور عبر LM Studio MCP محليًا: دليل الإعداد خطوة بخطوة

تكتب جملة واحدة في نافذة دردشة على جهازك، وبعد ثوانٍ قليلة تظهر صورة فوتوغرافية كاملة داخل المحادثة. لا علامة تبويب في المتصفح، ولا نسخ ولصق بين التطبيقات، ولا روبوت دردشة سحابي يقرأ مسوداتك. هذا ما يشعر به المستخدم عند توليد الصور عبر LM Studio MCP بعد ربط المكونات ببعضها، ويستغرق الربط نحو خمس عشرة دقيقة. يتبع هذا الدليل الإعداد بالترتيب: تثبيت LM Studio، واختيار نموذج يستطيع استدعاء الأدوات، وتعديل mcp.json، وإضافة أداة للصور، والموافقة على أول استدعاء، ومعالجة المشكلات التي تعثر معظم المحاولات الأولى.

كل ملف وكل أمر في الأسفل مصمم لتنسخه كما هو. وحين تعتمد إحدى التفاصيل على جهازك، يوضح لك التنبيه ما يجب التحقق منه قبل المتابعة.

لماذا نشغّل هذا محليًا؟

ما الذي يفعله MCP هنا

MCP، أي بروتوكول سياق النموذج (Model Context Protocol)، طريقة معيارية يسلّم بها التطبيق الأدوات إلى نموذج لغوي. وLM Studio هو المضيف: يحمّل النموذج على جهازك، ويتصل بخادم واحد أو أكثر من خوادم MCP، ويعرض على النموذج ما يستطيع كل خادم فعله. وعندما يقرر النموذج أن أداة ما مفيدة، يشغّلها LM Studio ويعيد النتيجة إلى المحادثة.

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

دردشة محلية ومحرك صور بعيد

هذا الفصل مهم لأنه يحدد ميزانية عتادك.

تشغيل نموذج صور إلى جانب نموذج دردشة على بطاقة رسومات استهلاكية واحدة ممكن لكنه ضيّق، لأن الاثنين يحتاجان ذاكرة الفيديو. أما توجيه الأداة إلى واجهة API مستضافة فيترك وحدة GPU متاحة للنموذج اللغوي. تبقى محادثتك وملفاتك وموافقاتك على الأدوات على جهازك، ولا ينتقل إلى الخارج سوى نص الأمر النصي النهائي. يسلك هذا الدليل المسار المستضاف ويستخدم واجهة PicassoIA API مثالًا عمليًا، لكن النمط نفسه يناسب أي خدمة صور.

💡 تريد كل شيء دون اتصال؟ استبدل الواجهة الخلفية للأداة بخادم صور محلي. يبقى جانب LM Studio من الإعداد كما هو تمامًا.

ما الذي تحتاجه قبل أن تبدأ

عتاد يعمل

حجم نموذج الدردشة يحدد الحد الأدنى. هذه الأرقام تقديرات تقريبية لإصدارات 4-bit وليست اختبارات معيارية، لذا اترك هامشًا لنافذة السياق.

تشارك أجهزة Mac التي تعمل بمعالجات Apple Silicon ذاكرة واحدة موحدة بين المعالج ووحدة GPU، ما يجعلها جيدة بشكل مدهش مع النماذج متوسطة الحجم. وعلى Windows وLinux، تعطي بطاقة NVIDIA بذاكرة VRAM سعتها 12 GB أو أكثر أفضل تجربة سلسة، ويعمل التشغيل بالمعالج وحده إذا قبلت ردودًا أبطأ.

قائمة مراجعة البرامج

• LM Studio 0.3.17 أو أحدث. أضاف ذلك الإصدار دعم MCP. النسخ الأقدم لا تحتوي على علامة التبويب Program.
• Node.js (أحدث إصدار LTS). مطلوب للخادم المحلي للأوامر الموضح أدناه.
• رمز مميز لخدمة الصور. بالنسبة إلى PicassoIA، أنشئ سرًا من صفحة API. يبدأ الرمز بـ pia_sk_.
• محرر نصوص عادي. المحرر المدمج في التطبيق يعمل، لكن نافذة ثانية تساعدك حين تقارن ملفات JSON.

تثبيت LM Studio ونموذج

التنزيل والتثبيت

نزّل المثبّت لنظام Windows أو macOS أو Linux من lmstudio.ai وشغّله كأي تطبيق سطح مكتب. افتح التطبيق، ثم تحقق من رقم الإصدار في الإعدادات. إذا كان أقل من 0.3.17، فحدّث التطبيق قبل المتابعة، لأن أيًا مما في القسم التالي غير موجود في النسخ الأقدم.

تعرض أول مرة تُشغَّل فيها التطبيق كتالوغًا للنماذج. تجاهل الأسماء الأكبر الآن. نموذج صغير يجيب خلال ثانيتين يخبرك عن إعدادك أكثر من نموذج ضخم يحتاج دقيقة لكل رد.

اختر نموذجًا جاهزًا للأدوات

استدعاء الأدوات سلوك مُدرَّب عليه النموذج. النموذج الذي لم يرَ أمثلة لاستخدام الأدوات سيتجاهل خادم الصور لديك أو يختلق استدعاءً معطوبًا. تحقق من بطاقة كل نموذج بحثًا عن "tool use" أو "function calling" قبل التنزيل.

نقطتا بداية معقولتان، ويمكن تجربتهما في المتصفح أولًا حتى تحكم على أسلوب كتابتهما قبل أن تستهلك عرض النطاق:

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

💡 نزّل إصدار 4-bit المكمّم أولًا. كتابة الأوامر النصية لا تتأثر كثيرًا، والملف يبلغ تقريبًا ربع حجم الإصدار كامل الدقة.

ربط خادم MCP

افتح mcp.json داخل التطبيق

1. افتح أي محادثة في LM Studio.
2. انتقل إلى علامة التبويب Program في الشريط الجانبي الأيمن.
3. انقر Install، ثم Edit mcp.json.
4. عدّل الملف في المحرر المدمج واحفظه.

يتبع LM Studio صيغة Cursor في mcp.json، لذا فالإعداد المكتوب لـ Cursor يُقرأ بالطريقة نفسها هنا. يفترض أن يبدأ الحفظ تشغيل الخادم وعرض أدواته. ظهور خطأ أحمر في هذه المرحلة يعني في الغالب وجود خطأ في JSON.

أضف خادمًا بعيدًا

تحتاج الخوادم البعيدة إلى عنوان URL، وغالبًا إلى ترويسة (header) تحمل بيانات اعتمادك:

{
  "mcpServers": {
    "image-service": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

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

استبدل عنوان URL بالعنوان الذي ينشره مزوّد الصور. تعرض PicassoIA اتصالات MCP داخل حسابك، لذا تحقق منها هناك لمعرفة تفاصيل الاتصال. إذا كان تسجيل الدخول لدى المزوّد يتطلب تسجيل دخول عبر المتصفح بدلًا من ترويسة ثابتة، فاستخدم مسار الأمر المحلي أدناه، فهو يعمل مع رمز مميز بسيط.

أضف خادم أوامر محليًا

الخادم المحلي برنامج صغير يشغّله LM Studio نيابة عنك:

{
  "mcpServers": {
    "image-tool": {
      "command": "node",
      "args": ["C:/tools/image-mcp/index.js"],
      "env": {
        "IMAGE_API_TOKEN": "pia_sk_paste_your_secret_here"
      }
    }
  }
}

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

استخدم الشرطة المائلة للأمام في مسارات Windows، أو ضاعف كل شرطة مائلة للخلف. الشرطة المائلة للخلف المفردة تكسر JSON فلا يبدأ الخادم أبدًا.

امنح النموذج أداة للصور

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

تتبع واجهة PicassoIA API نمط Replicate: تنشئ تنبؤًا، ثم تستعلم عن حالته، ثم تقرأ المخرجات. يبدو استدعاء cURL هكذا:

curl -s -X POST https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions \
  -H "Authorization: Bearer $IMAGE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a lighthouse at sunset, film photograph", "aspect_ratio": "16:9"}}'

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

داخل خادمك، يكون التدفق نفسه دالة قصيرة واحدة. ضعها داخل معالج أداة مبني باستخدام MCP SDK الرسمي للغتك:

const API = "https://api.picassoia.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.IMAGE_API_TOKEN}`,
  "Content-Type": "application/json",
};

async function makeImage(prompt, aspect_ratio = "16:9") {
  const start = await fetch(
    `${API}/models/picassoia/picassoia-image/predictions`,
    { method: "POST", headers, body: JSON.stringify({ input: { prompt, aspect_ratio } }) }
  );
  let job = await start.json();

  while (["starting", "processing"].includes(job.status)) {
    await new Promise((r) => setTimeout(r, 2000));
    job = await (await fetch(`${API}/predictions/${job.id}`, { headers })).json();
  }

  if (job.status !== "succeeded") throw new Error(`Image job ${job.status}`);
  return Array.isArray(job.output) ? job.output[0] : job.output;
}

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

أربع حقائق ينبغي أن تبقى في ذهنك:

• المهام غير متزامنة، بالحالات starting وprocessing وsucceeded وfailed وcanceled.
• يشغّل الحساب 5 تنبؤات في وقت واحد، مشتركة بين كل الرموز والاتصالات.
• الأوامر النصية محدودة بحد أقصى 4,000 حرف.
• النموذج الذي يقف خلف هذا الاستدعاء هو PicassoIA Image. وللتعديلات، يستخدم PicassoIA Image Editor Pro نمط API نفسه.

💡 تحقق من خطتك. يعتمد الوصول إلى API على خطتك في PicassoIA، لذا اقرأ الشروط الحالية في صفحة الأسعار قبل أن تبني عليها روتينًا يوميًا.

التشغيل الأول في نافذة الدردشة

افتح محادثة جديدة، وحمّل نموذجك الجاهز للأدوات، وتأكد من ظهور الخادم مفعّلًا في علامة التبويب Program. ثم اطلب شيئًا محددًا:

Generate a 16:9 photograph of a quiet harbor at sunrise, fishing boats at rest, soft haze, shot on 35mm film.

هكذا تبدو دورة كاملة بعد ربط كل شيء:

1. ترسل الجملة أعلاه.
2. يكتب النموذج توجيهًا مفصّلًا من نحو 50 كلمة، ويقرر استدعاء generate_image.
3. يتوقف LM Studio ويطلب موافقتك.
4. ينشئ الخادم التنبؤ، ويستعلم عنه، ويعيد رابطًا.
5. يرد النموذج بالرابط ووصف من سطر واحد لما طلبه.

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

وافق على استدعاء الأداة

عندما يستدعي النموذج أداتك، يعرض LM Studio أولًا نافذة تأكيد. يمكنك مراجعة المعاملات وتعديلها ثم الموافقة. اختر allow once أثناء الاختبار، أو always allow لأداة تثق بها. يمكن إدارة الأذونات الدائمة لاحقًا في إعدادات التطبيق.

اقرأ المعاملات في كل مرة في البداية. هنا ترى ما كتبه النموذج فعلًا: الأمر النصي، والنسبة، وأي إضافة غريبة. النموذج الذي يرسل مقالًا من 3,000 حرف إلى أداة صُممت لفقرة واحدة يحتاج موجّه نظام أكثر صرامة.

بعد موافقتك، تعمل الأداة، وتعيد رابط صورة، ويعود النموذج ليخبرك بالنتيجة في المحادثة. افتح الرابط لترى النتيجة.

اكتب أوامر نصية تنجح

تكتب النماذج أوامر صور أفضل حين يخبرها موجّه النظام بالكيفية. الصق هذا في حقل موجّه النظام:

أنت مدير تصوير فوتوغرافي. عندما يُطلب منك صورة، استدعِ generate_image بأمر نصي واحد من 40 إلى 70 كلمة: الشخص والحركة، والمكان، واتجاه الإضاءة، والعدسة والمسافة، وملمس السطح. لا تطلب أبدًا أنماط النيون أو الكرتون أو ثلاثية الأبعاد.

لماذا ينجح هذا؟ لأن نماذج الصور تستجيب للإشارات نفسها التي يفكر بها المصوّر.

• الشخص والفعل يأتيان أولًا، بكلمات بسيطة.
• الإضاءة تأخذ اتجاهًا: "ضوء نافذة من اليسار" أو "ظهر غائم".
• العدسة والمسافة تحددان الكادرة: "لقطة مقربة بعدسة 85mm" أو "لقطة عريضة بعدسة 24mm".
• الملمس يضيف الواقعية: "نسيج صوف"، "حجر مبلل"، "حبيبات فيلم ناعمة".

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

إصلاح المشكلات والبقاء آمنًا

الخادم لا يبدأ

اتبع هذه القائمة بالترتيب:

1. تحقق من صحة JSON. فاصلة زائدة واحدة تكفي لإيقاف كل شيء.
2. شغّل الأمر يدويًا. الصق command وargs في الطرفية. إذا فشل هناك، فسيفشل في LM Studio أيضًا.
3. تحقق من المسار. الشرطات المائلة للأمام في Windows، ولا مسافات زائدة.
4. تحقق من متغير البيئة. الرمز الفارغ يسبب خطأ تفويض من API بدلًا من التعطل، لذا اقرأ نص خطأ الأداة.

النموذج يتجاهل الأداة

ثلاثة أسباب تفسر معظم الحالات:

• النموذج لم يُدرَّب على الأدوات. انتقل إلى نموذج تُدرج بطاقته استخدام الأدوات.
• أدوات كثيرة. توثيق LM Studio نفسه يحذّر من أن الخوادم المبنية لمساعدي السحابة قد تستهلك عددًا كبيرًا من التوكنات وتثقل النموذج المحلي. أبقِ خادمًا أو اثنين نشطين، لا عشرة.
• نافذة السياق قصيرة. ارفع طول السياق حتى تتسع أوصاف الأدوات وسجل المحادثة معًا.

💡 مهمة عالقة في المعالجة؟ تذكّر حد 5 تنبؤات في وقت واحد. تعرض API أيضًا POST /v1/predictions/{id}/cancel لمسح المهام التي تتوقف.

احمِ رمز API الخاص بك

يقول توثيق LM Studio ذلك بوضوح: لا تثبّت أبدًا خوادم MCP من مصادر غير موثوقة. يستطيع الخادم تشغيل شيفرة عشوائية، وقراءة الملفات المحلية، واستخدام اتصالك بالشبكة. تعامل مع كل مدخل في mcp.json كأنه تطبيق تثبّته.

أما رمزك المميز فاحفظه كما يلي:

• احتفظ بالسر داخل كتلة env، ولا تضعه أبدًا في رسالة دردشة أو أمر نصي.
• تذكّر أن mcp.json يخزّن الرمز كنص عادي، لذا لا ترفع هذا الملف أبدًا إلى مستودع عام.
• تسمح PicassoIA برمزين لكل حساب، لذا بدّل الرموز واحدًا تلو الآخر: أنشئ الجديد، وحدّث mcp.json، ثم احذف القديم.
• أبقِ الموافقات على allow once لأي خادم لم تكتبه بنفسك.

كيف تستخدم P Image على PicassoIA

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

1. افتح صفحة النموذج. انتقل إلى صفحة P Image.
2. الصق الأمر النصي. الأمر النصي هو الحقل الوحيد المطلوب. استخدم الأمر الذي كتبه نموذجك المحلي.
3. اضبط نسبة العرض إلى الارتفاع. القيمة الافتراضية هي 1:1. اختر 16:9 للصور العريضة، أو custom مع عرض وارتفاع من مضاعفات 16.
4. اضبط الإعدادات الاختيارية. فعّل خيار إثراء الأوامر القصيرة. أدخل قيمة بذرة حين تريد إعادة إنتاج نتيجة.
5. وَلِّد. انقر زر التوليد وانتظر نحو ثانية.
6. نزّل. احفظ الصورة وقارنها بما أعادته أداتك في LM Studio.

إذا بدت المسودة صحيحة لكنك تريد مظهرًا مختلفًا، شغّل الأمر نفسه عبر Z-Image Turbo أو Flux 2 Klein 4B أو Seedream 4.5، واحتفظ بالنتيجة التي تناسب مشروعك.

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

صار لديك الآن نافذة دردشة تكتب التوجيهات، ومحرك يحوّلها إلى صور فوتوغرافية. جرّب جولة واحدة الليلة. اطلب من نموذجك المحلي ثلاثة أوامر نصية عن مشهد يهمك، والصق كل واحد في P Image على Picasso IA، وانظر أي صياغة تمنحك أوضح نتيجة. ثم أرسل الأسلوب الفائز إلى أداة LM Studio، وشاهد الصورة نفسها تظهر دون أن تغادر المحادثة.

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