Install
npx @modelcontextprotocol/inspectorلمن يناسب
استخدم mcp-builder عندما تريد إنشاء خادم MCP (Model Context Protocol) عالي الجودة ليتمكن النموذج من استدعاء واجهة أو خدمة خارجية عبر أدوات مصممة جيدًا. يمكن أن تكون اللغة Python (FastMCP) أو Node/TypeScript (MCP SDK). هذا دليل بناء، لا مستضيف لخادم غير مسمّى.
الفرضية الأنسب: أن تقبل إجراء بحث عميق وتخطيط أولاً بدل كتابة الواجهات فورًا. تكتب المادة TypeScript كخيار بدعم SDK أفضل وتوافق أفضل عبر بيئات تشغيل متعددة (مثل MCPB). لا تقدم المادة قائمة بمنتجات وكلاء ولا مسار تثبيت مستودع. صفحة الدليل الرسمية هي
https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md
أكمل أول محاولة في 3 دقائق
لا يعطي هذا الدليل أمر تثبيت skill؛ لا تخترع مسارًا في المحاولة الأولى. المسار الموصى به يبدأ من المرحلة الأولى: Deep Research and Planning. لخادم MCP عالي الجودة أربع مراحل رئيسية؛ المقتطف يكتب بالكامل عنوان المرحلة الأولى فقط، لذا المحاولة الأولى تخطيط فقط — لا تكتب عملية خادم.
الشرط المسبق: لديك أصلًا واجهة أو خدمة خارجية للربط. إجراء منخفض المخاطر: سرد أي استعلامات في تلك الخدمة للقراءة فقط وأيها يغيّر البيانات، والقرار بأن البعيد يستخدم Streamable HTTP. يذكر الملخص أيضًا stdio للمحلي، لكن المقتطف يكتب فقط Streamable HTTP للبعيد؛ لا تفترض أن وسائط stdio مكتوبة بالكامل أصلًا.
إشارة النجاح: صفحة واحدة تستطيع أن تقول بوضوح «أي أدوات يحصل عليها النموذج وما القيود على المدخلات». لا تشغّل أولاً npm init لمشروع بلا خطة. بعد تأكيد الخطة انتقل إلى التنفيذ. في جانب TypeScript يمكن استخدام Zod لـ schema الإدخال؛ تحتاج الحقول إلى قيود ووصف واضح وأمثلة في وصف الحقل. أكّد الدليل قبل كتابة الملفات.
حالات الاستخدام
الحالة الأولى: تخطيط خادم بعيد على مكدس TypeScript الموصى به. اختر MCP SDK، والنقل Streamable HTTP، والمدخلات Zod، مع قيود وأمثلة في الأوصاف. يذكر الملخص أيضًا outputSchema/structuredContent وتعليقات مثل readOnlyHint و destructiveHint، لكن المقتطف لا يكتب أمثلة كاملة لتلك الحقول. معيار إكمال هذه الحالة هو أن الخطة تفصل أدوات القراءة فقط عن الأدوات التي تغيّر البيانات، لا أن كل التعليقات قد مُلئت. لا تبدأ مكدس Python في الوقت نفسه كـ «مسار رئيسي»؛ Python FastMCP و Pydantic خياران متوازيان وليسا كتابة مزدوجة إلزامية.
الحالة الثانية: بعد التنفيذ، الترجمة والفحص. مسار TypeScript هو أولاً npm run build لتأكيد الترجمة ثم MCP Inspector: npx @modelcontextprotocol/inspector. يفتح Inspector واجهة فحص فله آثار جانبية؛ أكّد أنك تختبر الخادم المحلي أو البعيد الذي بنيته للتو ثم نفّذ. معيار الإكمال: ينجح build ويستطيع Inspector الاتصال بالخدمة التي سمّيتها. لا يكتب المقتطف كل أعلام Inspector فلا تخترع معاملات اتصال.
حدود الاستخدام
تبدأ المراحل الأربع الرئيسية بالبحث العميق والتخطيط؛ لاحقًا يلخّص الملخص التنفيذ ثم الفحص/الاختبار، لكن عناوين المراحل الباقية غير موسّعة في المقتطف. النقل البعيد مكتوب كـ Streamable HTTP. يستخدم schema الإدخال Zod أو Pydantic. أوامر فحص TypeScript هي npm run build و Inspector الرسمي.
لا تخترع مسار تثبيت داخل المستودع. لا تعطي المادة قائمة عملاء ولا كيفية تخطي التخطيط والنشر مباشرة. ما يتجاوز هذه المراحل وخيارات اللغة وأوامر الفحص المكتوبة هنا خارج تغطية هذا الدليل.