حل خطأ MCP tool schema invalid — فحص مخطط المدخلات

ما سبب خطأ MCP tool schema invalid؟

قد يرفض العميل تعريف الأداة قبل تنفيذها إذا كان inputSchema غير متوافق مع ما يتوقعه العميل، أو إذا كان required يشير إلى حقل لا تسمح به بقية القواعد. قد يفشل طلب الأداة أيضًا بسبب مدخلات غير صالحة حتى لو كان التعريف صحيحًا.

خطوات التشخيص

راجع schema المنشور فعليًا بعد tools/list. افصل بين رفض تعريف الأداة وبين رفض وسيطات tools/call. اختبر بمثال اصطناعي صغير، ثم أعد الاتصال كي لا يعتمد العميل على تعريف مخزن سابقًا.

مثال JavaScript آمن

هذا المثال يكتشف تعارض required مع properties عندما تكون additionalProperties=false. لا يتصل بأي خادم ولا يستخدم بيانات عملاء.

const schema={type:'object',properties:{url:{type:'string'}},required:['target'],additionalProperties:false};
const conflict=schema.required.filter(x=>!Object.hasOwn(schema.properties,x)&&schema.additionalProperties===false);
console.log(conflict); // ['target']
schema.required=['url'];
console.log(schema.required.filter(x=>!Object.hasOwn(schema.properties,x)&&schema.additionalProperties===false)); // []

ماذا بعد الفحص؟

إن استمر الخطأ، احتفظ بنسخة مختصرة من المخطط ورسالة التحقق بعد إزالة الأسرار. صفحة التشخيص الإنجليزية مرتبطة أدناه، والإصلاح المدفوع اختياري ومحدد النطاق.

روابط مفيدة

الشرح الإنجليزي والأدوات التفاعلية

عرض نطاق الخدمة الاختيارية وسعرها الحالي

الفحص المجاني ليس إصلاحًا مكتملًا، وأي خدمة مدفوعة تتطلب موافقة مستقلة. لا تُدخل أسرارًا أو بيانات عملاء.