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

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 (نموذج بروتوكول السياق) هو بروتوكول سياق النموذج الذي أطلقته شركة Anthropic، والذي يسمح لنماذج الذكاء الاصطناعي (مثل Claude وGPT وغيرها) باستدعاء أدوات خارجية من خلال واجهات موحدة. من خلال خادم Suno MCP المقدم من XHuoAPI، يمكنك مباشرةً إنشاء موسيقى وكلمات وإدارة مشاريع صوتية في عملاء الذكاء الاصطناعي مثل Claude Desktop وVS Code وCursor.

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

يوفر خادم Suno MCP الوظائف الأساسية التالية:
  • توليد الموسيقى — توليد موسيقى AI من خلال نصوص ترويجية
  • الإبداع المخصص — التحكم الكامل في الكلمات والعناوين وأسلوب الموسيقى
  • استكمال الأغاني — مواصلة تمديد الأغاني الموجودة من أي نقطة زمنية
  • إعادة الغناء/المزج — إنشاء نسخ مغطاة بأساليب مختلفة
  • توليد الكلمات — توليد كلمات منظمة بناءً على الوصف
  • أدوار الصوت البشري — حفظ وإعادة استخدام أنماط الصوت
  • تحويل الوسائط — الحصول على MP4 وWAV وMIDI وفصل الصوت البشري وغيرها
  • تحسين الأسلوب — تحسين علامات أسلوب الموسيقى
  • استعلام المهام — مراقبة تقدم التوليد والحصول على النتائج

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

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

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

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

pip install mcp-suno

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

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

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

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

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

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

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

اسم الأداةالوصف
suno_generate_musicتوليد موسيقى من خلال نصوص ترويجية
suno_generate_custom_musicتوليد موسيقى مع كلمات وأسلوب مخصص
suno_extend_musicاستكمال الأغاني من نقطة زمنية محددة
suno_cover_musicإنشاء نسخ مغطاة
suno_concat_musicدمج مقاطع الأغاني
suno_generate_with_personaتوليد موسيقى باستخدام أدوار صوت محددة
suno_remaster_musicإعادة معالجة الصوت
suno_stems_musicفصل المسارات (صوت بشري/موسيقى)
suno_replace_sectionاستبدال مقاطع محددة في الأغاني
suno_upload_extendرفع الصوت واستكماله
suno_upload_coverرفع الصوت وإعادة غنائه
suno_mashup_musicمزج عدة أغاني
suno_generate_lyricsتوليد كلمات بناءً على الوصف
suno_create_personaإنشاء أدوار صوت
suno_get_mp4الحصول على فيديو MP4 للأغاني
suno_get_timingالحصول على توقيت الكلمات
suno_extract_vocalsاستخراج الصوت البشري
suno_get_wavالحصول على WAV عالي الجودة
suno_get_midiالحصول على ملفات MIDI
suno_optimize_styleتحسين علامات أسلوب الموسيقى
suno_mashup_lyricsمزج الكلمات
suno_upload_audioرفع صوت مخصص
suno_get_taskاستعلام عن حالة مهمة واحدة
suno_get_tasks_batchاستعلام عن حالة المهام بشكل جماعي

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

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

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