Kokoro TTS MCP: أنشئ أولًا ملف mp3 على الجهاز

لمن يناسب

إذا كنت تريد تحويل النص إلى mp3 ثم رفعه اختياريًا إلى S3 فإن هذه الخدمة تناسب ذلك. يصفها النص الرسمي بأنها خادم MCP لـ Kokoro Text to Speech يولّد mp3 محليًا ويقدّم خيار الرفع إلى S3.

تناسب من يستطيع أصلًا استنساخ المستودع الرسمي واستخدام uv وتنزيل أوزان onnx. يطلب النص الرسمي وضع kokoro-v1.0.onnx وvoices-v1.0.bin في دليل المستودع نفسه. يلزم أيضًا ffmpeg لتحويل wav الوسيط إلى mp3. على Mac التثبيت الرسمي هو brew install ffmpeg.

لا تناسب من يريد واجهة سحابية فقط أو لا يقبل سقوط ملفات صوت على الجهاز. التوليد نفسه يكتب mp3 على القرص. ولا تناسب من يريد إرسال النتيجة إلى S3 في المرة الأولى: ذلك يخرج الصوت عن الجهاز.

المستودع الرسمي:

https://github.com/mberg/kokoro-tts-mcp

مصدر الأوزان:

https://github.com/thewh1teagle/kokoro-onnx

إكمال المحاولة الأولى في 3 دقائق

المسار الرسمي الموصى به واحد فقط: في المستودع المحلي الذي يحمل الأوزان أصلًا شغّل mcp-tts.py بـ uv. لا تبحث عن مثبّت آخر ولا تهيئ S3 في المرة الأولى.

uv run mcp-tts.py

المتطلبات: المستودع الرسمي موجود على الجهاز؛ نُزّل kokoro-v1.0.onnx وvoices-v1.0.bin ويقفان بجانب السكربت؛ ffmpeg موجود. عناوين ملفات الأوزان:

https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx

https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin

موضع الإعداد: اكتب أمر uv أعلاه في بند تشغيل خادم عميل MCP الحالي، ودليل العمل يشير إلى ذلك المستودع. بعد الاتصال نفّذ استدعاءً منخفض المخاطر: من الأدوات التي يعرضها هذا الخادم في العميل اختر بند توليد mp3 محلي. النص الرسمي لا يسرد أسماء الدوال متتالية؛ لا تخترع أسماء دوال. التركيب يكتب ملفًا على الجهاز ويشغل القرص أيضًا.

إشارة النجاح: يظهر mp3 جديد في دليل المستودع ولم يُرفع إلى S3. إن فشل التشغيل فتحقق أولًا أن ملفي الأوزان مع mcp-tts.py وأن ffmpeg متاح.

حالات الاستخدام

الحالة الأولى: أخرج صوتًا على الجهاز. الهدف توليد mp3 وحفظه محليًا. استخدم أداة التركيب التي يعرضها العميل فعلًا وأدخل سطرًا قصيرًا بلا خصوصية. الأدلة بلا جدول معاملات ولا اسم حقل نبرة؛ النجاح ظهور mp3 محلي. لا تفترض تشغيلًا تلقائيًا.

الحالة الثانية: رفع S3 اختياري. يوضح النص الرسمي أن mp3 موجود محليًا ويمكن رفعه إلى S3 ويمكن أيضًا تهيئة كيفية إدارة هذه الملفات. ذلك خروج إلى الشبكة. نقطة التأكيد أنك رأيت الصوت الذي سيُرفع وتقبل دخوله إلى تخزين الكائنات ثم تتحرك. هذه الصفحة لا تكتب أسماء متغيرات المفاتيح؛ لا تخترعها. إن لم يكن لدى العميل بند رفع فقف هنا.

حدود الاستخدام

لا تشغّل بلا ملفات أوزان أو ffmpeg. النص الرسمي كتب فقط brew install ffmpeg على Mac؛ لا تعِد كتابته كأمر مدير حزم لنظام آخر. uv هو التشغيل الموصى به؛ لا تبدّله بمثبّت حزم لم يظهر.

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