خادم MCP الرسمي لـ ElevenLabs، يدعم تحويل النص إلى كلام، واستنساخ الصوت، والنسخ الصوتي، ووظائف معالجة الصوت بالذكاء الاصطناعي الأخرى.

مقدمة مفصلة لخادم ElevenLabs MCP

نظرة عامة على المشروع

خادم ElevenLabs MCP هو خادم بروتوكول سياق النموذج (MCP) الرسمي من ElevenLabs، يدعم التفاعل مع واجهات برمجة تطبيقات قوية لتحويل النص إلى كلام ومعالجة الصوت. يسمح هذا الخادم لعملاء MCP مثل Claude Desktop و Cursor و Windsurf و OpenAI Agents بإنشاء كلام واستنساخ الأصوات ونسخ الصوتيات وغيرها من الوظائف.

الوظائف الأساسية

الميزات الرئيسية

• تحويل النص إلى كلام (TTS): تحويل النص إلى كلام طبيعي.
• استنساخ الصوت: نسخ ومحاكاة خصائص صوتية محددة.
• نسخ الصوت: تحويل ملفات الصوت إلى نص.
• تصميم الصوت: إنشاء وتخصيص تكوينات صوتية فريدة.
• عزل الصوت: فصل أصوات معينة من الصوتيات المعقدة.
• إنشاء المؤثرات الصوتية: إنشاء مجموعة متنوعة من المؤثرات الصوتية والمناظر الصوتية.

العملاء المدعومون

• Claude Desktop
• Cursor
• Windsurf
• OpenAI Agents
• عملاء آخرون متوافقون مع بروتوكول MCP

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

المتطلبات الأساسية

1. احصل على مفتاح API من ElevenLabs (توفر النسخة المجانية 10 آلاف نقطة شهريًا).
2. قم بتثبيت uv (مدير حزم Python):

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

تكوين Claude Desktop

في Claude > Settings > Developer > Edit Config > claude_desktop_config.json، أضف التكوين التالي:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<ضع-مفتاح-API-الخاص-بك-هنا>"
      }
    }
  }
}

ملاحظة لمستخدمي Windows: تحتاج إلى تمكين "وضع المطور" في Claude Desktop. انقر فوق "Help" في قائمة الهامبرغر في الزاوية العلوية اليسرى وحدد "Enable Developer Mode".

تكوين العملاء الآخرين

بالنسبة لعملاء مثل Cursor و Windsurf:

pip install elevenlabs-mcp
python -m elevenlabs_mcp --api-key={{ضع_مفتاح_API_الخاص_بك_هنا}} --print

ثم الصق التكوين الناتج في دليل تكوين عميل MCP المقابل.

أمثلة الاستخدام

بعد التثبيت، يمكنك تجربة العمليات التالية:

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

التطوير والمساهمة

التشغيل من المصدر

1. استنساخ المستودع:

   git clone https://github.com/elevenlabs/elevenlabs-mcp
   cd elevenlabs-mcp
   

2. إنشاء بيئة افتراضية وتثبيت التبعيات:

   uv venv
   source .venv/bin/activate
   uv pip install -e ".[dev]"
   

3. تكوين متغيرات البيئة:

   cp .env.example .env
   # تحرير ملف .env وإضافة مفتاح API الخاص بك
   

4. تشغيل الاختبارات:

   ./scripts/test.sh
   # أو التشغيل مع الخيارات
   ./scripts/test.sh --verbose --fail-fast
   

التصحيح والاختبار

• تثبيت الخادم في Claude Desktop:

  mcp install elevenlabs_mcp/server.py
  

• استخدام MCP Inspector للتصحيح المحلي:

  mcp dev elevenlabs_mcp/server.py
  

موقع السجلات

موقع ملفات السجل لوقت تشغيل Claude Desktop:

• Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

البنية التقنية

خادم ElevenLabs MCP هو طبقة تجريد لواجهة برمجة تطبيقات ElevenLabs، مما يوفر للنماذج اللغوية الكبيرة الوصول إلى منصة ElevenLabs AI الصوتية الكاملة. إنه يعمل كواجهة محلية سهلة الاستخدام للمطورين، ويعيد توجيه الطلبات إلى واجهة برمجة تطبيقات ElevenLabs السحابية.

ملاحظات

1. معالجة المهلة: قد تستغرق بعض عمليات واجهة برمجة تطبيقات ElevenLabs (مثل تصميم الصوت وعزل الصوت) وقتًا أطول لإكمالها. قد تحدث أخطاء المهلة في وضع تطوير MCP inspector، ولكن ستظل المهمة مكتملة. لن تحدث هذه المشكلة عند استخدام عملاء مثل Claude.

2. تكوين المسار: يمكنك تحديد المسار الأساسي الذي يبحث فيه خادم MCP عن الملفات ذات المسارات النسبية ويخرجها عن طريق إضافة متغير البيئة ELEVENLABS_MCP_BASE_PATH.

3. استكشاف الأخطاء وإصلاحها: إذا واجهت خطأ "MCP ElevenLabs: spawn uvx ENOENT"، فاستخدم الأمر which uvx لتأكيد المسار المطلق، ثم استخدم المسار الكامل في التكوين (مثل "command": "/usr/local/bin/uvx").

قيمة المشروع

يوفر هذا المشروع لمطوري تطبيقات الذكاء الاصطناعي:

• واجهة موحدة لمعالجة الصوت
• تكامل سلس لتوليف الكلام
• قدرات قوية لتحليل الصوت
• توافق عبر الأنظمة الأساسية
• جودة صوت على مستوى المؤسسات

من خلال بروتوكول MCP، يمكن للمطورين بسهولة دمج قدرات معالجة الصوت عالية الجودة من ElevenLabs في مجموعة متنوعة من تطبيقات الذكاء الاصطناعي، مما يبسط بشكل كبير عملية تطوير الوظائف المتعلقة بالصوت.