الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) هو بروتوكول سياق النموذج الذي أطلقته Anthropic، والذي يسمح لنماذج الذكاء الاصطناعي مثل Claude و GPT وغيرها باستدعاء أدوات خارجية عبر واجهة موحدة. من خلال خادم Seedream MCP الذي توفره XHuoAPI، يمكنك استخدام Seedream من ByteDance لتوليد وتحرير صور الذكاء الاصطناعي مباشرة في عملاء الذكاء الاصطناعي مثل Claude Desktop و VS Code و Cursor.

​
نظرة عامة على الوظائف

يقدم خادم Seedream MCP الوظائف الأساسية التالية:
  • توليد الصور من النصوص — توليد صور عالية الجودة عبر أوامر نصية (يدعم اللغتين الصينية والإنجليزية)
  • تحرير الصور — تعديل أسلوب الصورة، الخلفية، الخصائص، وغيرها
  • التجريب الافتراضي للملابس — وضع الملابس على صور الأشخاص
  • دعم نماذج متعددة — يدعم نماذج Seedream v4.5، v4.0، v3.0 T2I، SeedEdit v3.0 I2I وغيرها
  • دقة متعددة — يدعم 1K، 2K، 4K ودقة متكيفة
  • التحكم بالبذرة (seed) — تحقيق نتائج قابلة للتكرار عبر معلمة seed
  • استعلام المهام — مراقبة تقدم التوليد والحصول على النتائج

​
المتطلبات المسبقة

قبل الاستخدام، تحتاج إلى الحصول على رمز API من XHuoAPI:
  1. قم بالتسجيل أو تسجيل الدخول إلى منصة XHuoAPI
  2. انتقل إلى صفحة Seedream Images API
  3. اضغط على “Acquire” للحصول على رمز API (يتم منح حصة مجانية عند الطلب الأول)

​
التثبيت والإعداد

​
الطريقة الأولى: التثبيت عبر pip (موصى به)

pip install mcp-seedream-pro

​
الطريقة الثانية: التثبيت من المصدر

git clone https://github.com/XHuoAPI/SeedreamMCP.git
cd SeedreamMCP
pip install -e .
بعد الانتهاء من التثبيت، يمكنك تشغيل الخدمة باستخدام الأمر mcp-seedream-pro.

​
الاستخدام في Claude Desktop

قم بتحرير ملف إعدادات Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
أضف الإعداد التالي: 
{
  "mcpServers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
إذا كنت تستخدم uvx (لا يتطلب تثبيت الحزم مسبقاً): 
{
  "mcpServers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
بعد حفظ الإعدادات، أعد تشغيل Claude Desktop لتتمكن من استخدام أدوات Seedream ضمن المحادثات.

​
الاستخدام في VS Code / Cursor

في مجلد المشروع الجذر، أنشئ ملف .vscode/mcp.json: 
{
  "servers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}
أو باستخدام uvx: 
{
  "servers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

​
قائمة الأدوات المتاحة

اسم الأداةالوصف
seedream_generate_imageتوليد صورة من نص
seedream_edit_imageتحرير أو تعديل صورة موجودة
seedream_get_taskاستعلام حالة مهمة واحدة
seedream_get_tasks_batchاستعلام حالة مهام متعددة
seedream_list_modelsعرض جميع النماذج المتاحة وقدراتها
seedream_list_sizesعرض أحجام ودقات الصور المتاحة

​
أمثلة على الاستخدام

بعد الإعداد، يمكنك استدعاء هذه الوظائف باللغة الطبيعية في عملاء الذكاء الاصطناعي، مثل:
  • “ساعدني في توليد صورة بأسلوب الرسم بالحبر الصيني باستخدام Seedream”
  • “غيّر خلفية هذه الصورة إلى سماء مرصعة بالنجوم”
  • “استخدم Seedream v4.5 لتوليد صورة شخصية بدقة 4K عالية”
  • “جرب هذه الملابس افتراضياً على هذه الصورة”

​
مزيد من المعلومات