ضبط نوع MIME الصحيح
أبلغوا العملاء بما إذا كان المحتوى نصًا أو JSON أو نوعًا آخر.
ضبط نوع MIME الصحيح درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
ما هو نوع MIME
نوع MIME هو تسمية قصيرة تخبر العميل بنوع المحتوى الذي يحمله المورد، مثل النص العادي أو JSON أو صورة.
لماذا يهم ذلك
تتيح التسمية للعميل عرض المحتوى وتحليله بطريقة صحيحة. وبدونها، قد يعرض العميل JSON الخام كنص أو يتعامل مع كتلة ثنائية بطريقة خاطئة. 🏷️
الافتراضي النصي
إذا لم تحدد شيئًا، يفترض MCP النوع text/plain. وهذا مناسب للملاحظات والمستندات، لكن البيانات المنظمة تستحق نوعًا أكثر دقة.
الأنواع الشائعة
ستستخدم عدة أنواع كثيرًا: text/plain للنثر، وapplication/json للبيانات، وtext/markdown للمستندات المنسقة التي يستطيع النموذج تحليلها.
التصريح به في FastMCP
اضبط النوع باستخدام المعامل mime_type في مزخرف المورد حتى يعرف العملاء بالضبط كيفية قراءة المحتوى.
@mcp.resource("data://stats", mime_type="application/json")
def stats():
return '{"users": 42}'استخدام JSON بالطريقة الصحيحة
بالنسبة إلى JSON، حدده بالنوع application/json وأعد سلسلة JSON صالحة. وأنشئها باستخدام مكتبة json حتى تكون علامات الاقتباس ومحارف الهروب صحيحة دائمًا.
import json
@mcp.resource("data://stats", mime_type="application/json")
def stats():
return json.dumps({"users": 42})استخدام Markdown للمستندات
هل تقدّم README أو دليلًا؟ استخدم text/markdown حتى تعرض العملاء القادرون العناوين والقوائم بدلًا من الرموز الخام.
@mcp.resource("docs://readme", mime_type="text/markdown")
def readme():
return "# Welcome\nGetting started..."طابق النوع مع المحتوى
يجب أن يصف النوع المحتوى بصدق. فتسمية النص العادي على أنه JSON تجعل العملاء يحاولون تحليله ويفشلون، لذا احرص دائمًا على تطابقهما.
تحتاج البيانات الثنائية إلى عناية
بالنسبة إلى الصور أو ملفات PDF، اضبط نوع MIME ثنائيًا مثل image/png، وتُنقل البايتات بترميز base64 حتى تصمد عبر بروتوكول نصي.
اكتشاف النوع من الامتداد
عند تقديم الملفات، يستطيع Python تخمين النوع من اسم الملف. وتربط مكتبة mimetypes الامتداد بنوع MIME القياسي المناسب نيابةً عنك.
import mimetypes
mt, _ = mimetypes.guess_type("report.json")
# mt == "application/json"عقد صغير
فكّر في نوع MIME بوصفه عقدًا صغيرًا: فهو يَعِد العميل بشكل البايتات حتى يتفق الطرفان قبل التحليل.
تحقق سريع
اختر النوع الصحيح للبيانات المنظمة.
مراجعة
يخبر نوع MIME العملاء بكيفية قراءة المورد. استخدم mime_type لضبط النص أو JSON أو markdown أو البيانات الثنائية، واحرص على أن يعكس المحتوى بصدق. 🏷️
تعلم Python مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «ضبط نوع MIME الصحيح» مجاني؟
نعم — نص درس «ضبط نوع MIME الصحيح» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «ضبط نوع MIME الصحيح»؟
أبلغوا العملاء بما إذا كان المحتوى نصًا أو JSON أو نوعًا آخر. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «ضبط نوع MIME الصحيح»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- شرح معرّفات URI الخاصة بالموارد
- تقديم مورد نصي ثابت
- قراءة ملف من القرص
- ضبط نوع MIME الصحيح