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

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

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

MCP (بروتوكول سياق النموذج) هو بروتوكول سياق النموذج الذي أطلقته شركة Anthropic، والذي يسمح لنماذج الذكاء الاصطناعي (مثل Claude وGPT وغيرها) باستدعاء أدوات خارجية من خلال واجهات موحدة. من خلال خادم Sora MCP المقدم من AceData Cloud، يمكنك استخدام OpenAI Sora لإنشاء مقاطع فيديو AI مباشرة في عملاء الذكاء الاصطناعي مثل Claude Desktop وVS Code وCursor.

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

يوفر خادم Sora MCP الوظائف الأساسية التالية:
  • إنشاء فيديو من نص — إنشاء فيديو عالي الجودة من خلال نصوص ترويجية
  • إنشاء فيديو من صورة — إنشاء فيديو بناءً على صورة
  • فيديو بتناسق الشخصيات — الحفاظ على تناسق الشخصيات باستخدام صور مرجعية
  • إنشاء غير متزامن — دعم تقديم المهام غير المتزامنة واستعلام النتائج
  • اتجاهات عرض متعددة — دعم العرض الأفقي (landscape) والعمودي (portrait)
  • استعلام المهام — مراقبة تقدم الإنشاء والحصول على النتائج

​
التحضيرات المسبقة

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

​
التثبيت والتكوين

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

pip install mcp-sora

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

git clone https://github.com/AceDataCloud/MCPSora.git
cd MCPSora
pip install -e .
بعد الانتهاء من التثبيت، يمكنك استخدام الأمر mcp-sora لبدء الخدمة.

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

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

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

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

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

اسم الأداةالوصف
sora_generate_videoإنشاء فيديو من نصوص ترويجية
sora_generate_video_from_imageإنشاء فيديو بناءً على صورة
sora_generate_video_with_characterإنشاء فيديو بتناسق الشخصيات باستخدام صورة مرجعية
sora_generate_video_asyncتقديم مهام إنشاء الفيديو بشكل غير متزامن
sora_get_taskاستعلام عن حالة مهمة واحدة
sora_get_tasks_batchاستعلام عن حالة المهام بشكل جماعي

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

بعد الانتهاء من التكوين، يمكنك استدعاء هذه الوظائف مباشرة بلغة طبيعية في عميل الذكاء الاصطناعي، مثل:
  • “ساعدني في إنشاء فيديو لقطط تجري على العشب باستخدام Sora”
  • “استخدم هذه الصورة لشخصية لإنشاء فيديو، مع الحفاظ على تناسق الشخصية”
  • “أنشئ فيديو عمودي، محتواه هو شروق الشمس في المدينة”
  • “أنشئ فيديو بشكل غير متزامن واستعلم عن النتائج لاحقًا”

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