/ الدليل / الملعب / inspector
← كل الخوادم ↗ GitHub
● مجتمع MCPJam ⚡ فوري

inspector

بواسطة MCPJam · MCPJam/inspector

أداة التصحيح التي تتمنى أن تملكها عند بناء خوادم MCP — تتبع JSON-RPC، وتقييم الأدوات عبر نماذج LLM المختلفة، ومطابقة OAuth، وتكامل CI.

MCPJam Inspector هي منصة تطوير لخوادم MCP. تطبيق ويب وتطبيق سطح مكتب وواجهة سطر أوامر و Docker. قم بتصحيح استدعاءات الأدوات، وتحدث مع أي نموذج LLM ضد خادمك، وقم بتشغيل اختبارات التقييم عبر النماذج المختلفة، وتكامل مع CI لاكتشاف الانحدارات في PR.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

inspector.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "inspector",
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "inspector"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add inspector -- npx -y inspector

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: inspector

كيفية تصحيح سبب عدم استدعاء أداة MCP الخاصة بك

👤 مطورو خوادم MCP ⏱ ~15 min intermediate

متى تستخدمه: كتبت أداة، لكن Claude لا يستخدمها، ولا تعرف السبب.

المتطلبات الأساسية
  • Node — nodejs.org أو nvm
الخطوات
  1. تشغيل Inspector
    قم بتشغيل npx @mcpjam/inspector@latest وافتح عنوان URL المطبوع.✓ تم النسخ
    → يتم فتح واجهة المستخدم في المتصفح
  2. ربط خادمك
    في واجهة المستخدم، أضف خادمك (stdio أو HTTP) واتصل.✓ تم النسخ
    → قائمة الأدوات تُملأ
  3. محاكاة موجه
    في علامة تبويب Chat، اطرح سؤالاً يجب أن يُشغّل أداتك. راقب تتبع JSON-RPC.✓ تم النسخ
    → إما أن تُشغّل الأداة (جيد) أو ترى لماذا رفضها النموذج (وصف سيء، مشكلة في schema)

النتيجة: سبب ملموس (وصف أداة خاطئ، مشكلة في schema، اختيار نموذج) مع حل مرئي.

المزالق
  • الاختبار باستخدام نموذج أضعف لا يستخدم الأدوات أبداً — اختبر عبر نماذج متعددة في علامة تبويب Evals — Haiku و Sonnet و GPT-4o — السلوك يختلف

كيفية تشغيل اختبارات التقييم على PRs لخادم MCP الخاص بك

👤 الفرق التي تحافظ على MCPs الإنتاجية ⏱ ~30 min advanced

متى تستخدمه: تريد اكتشاف 'عذراً، هذا الموجه لم يعد يختار أداتي' في CI.

الخطوات
  1. إنشاء التقييمات
    في Inspector، أنشئ حالات التقييم: (prompt, expected_tool_called, expected_args).✓ تم النسخ
    → تم حفظ مجموعة التقييمات
  2. ربط مع CI
    استخدم CLI لتشغيل التقييمات على كل PR؛ فشل البناء عند حدوث انحدار.✓ تم النسخ
    → يتم تشغيل evals بواسطة .github/workflows/mcp-eval.yml

النتيجة: لا تندمج PRs التي تكسر اختيار الأداة.

المزالق
  • التقييمات غير مستقرة عندما يكون temperature > 0 — استخدم temperature 0 في تشغيلات التقييم
اجمعها مع: github

كيفية تشخيص تدفق OAuth المكسور على خادم MCP الخاص بك

👤 مطورو خادم MCP يشحنون أدوات محمية بـ OAuth ⏱ ~20 min advanced

متى تستخدمه: الرموز لا تُحدّث، أو يُرجع إعادة التوجيه 400.

الخطوات
  1. تفعيل تصحيح OAuth في Inspector
    قم بتكوين نقاط نهاية OAuth لخادمك وانقر على 'Test flow'.✓ تم النسخ
    → تتبع خطوة بخطوة للترخيص والرمز والتحديث
  2. تحديد الكسر
    يسلط Inspector الضوء على الخطوات غير المطابقة (content-type خاطئ، PKCE مفقود، scope سيء).✓ تم النسخ
    → عقدة فشل محددة

النتيجة: تطبيق OAuth متوافق.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

inspector + github

قم بتشغيل evals Inspector في GitHub Action على PRs لخادم MCP الخاص بك

قم بإعداد GitHub Action باستخدام @mcpjam/inspector CLI لتشغيل evals على كل PR يتعلق بـ src/tools/.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(inspector app) connect-server transport: stdio|http, command or url الخطوة الأولى free
(inspector app) execute-tool tool, args الاختبار اليدوي depends on tool
(inspector app) chat-and-inspect model, prompt محاكاة شاملة 1 LLM call
(inspector app) run-evals suite_id اختبار الانحدار في CI N LLM calls

التكلفة والحدود

تكلفة التشغيل

حصة API
مفاتيح LLM/eval الخاصة بك تحدد الميزانية
الرموز لكل استدعاء
يمكن للتقييمات أن تستهلك الرموز — قم بتحديد التزامن والحجم
التكلفة المالية
Inspector نفسها مجانية. التطبيق المستضاف في app.mcpjam.com له مستويات.
نصيحة
قم بتشغيل التقييمات على Haiku لاختبارات الدخان الرخيصة؛ احتفظ بـ Sonnet/Opus للتشغيلات الليلية.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: أي نطاقات يحتاجها خادم MCP الخاص بك مفاتيح مزود LLM للتقييمات
تخزين بيانات الاعتماد: متغيرات البيئة المحلية لـ CLI؛ أسرار مساحة العمل للتطبيق المستضاف
نقل البيانات الخارجي: تبقى استدعاءات الأدوات بين MCP و LLM الخاص بك؛ التطبيق المستضاف يخزن نتائج التقييم في مساحة عملك
لا تمنح أبدًا: لا تحمل أسرار عميل OAuth الإنتاجية إلى التطبيق المستضاف بدون مراجعة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Can't connect to my stdio server

تأكد من أن الأمر الذي يشغّله Inspector يطابق ما يشغّله Claude Desktop — دليل العمل والمتغيرات البيئية مضمنة.

Chat tab says 'model not configured'

أضف مفتاح Anthropic/OpenAI الخاص بك في الإعدادات.

Evals pass locally, fail in CI

عدم تطابق البيئة — حدّد نفس النموذج و temperature في CI كما هو محلي.

OAuth test reports 'state mismatch'

خادمك لا يحافظ على معامل state؛ قارن مع المواصفات في تقرير المطابقة الخاص بـ Inspector.

البدائل

inspector مقابل البدائل

البديلمتى تستخدمهاالمقايضة
@modelcontextprotocol/inspector (رسمية)تريد مفتش المرجع من الطرف الأولسطح ميزة أصغر؛ لا توجد evals/CI
mcp-client-for-ollamaتريد عميل Ollama للمحطة فقطليست أداة تصحيح، بل عميل فقط

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills