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

MCPJam Inspector

بواسطة MCPJam · MCPJam/inspector

Postman لـ MCP — اتصل بأي خادم، استعرض أدواته، استدعها يدوياً، تحدث معه كعامل، وقيّم المخرجات عبر نماذج لغوية متعددة في واجهة واحدة محلية.

MCPJam Inspector منصة تطوير لـ MCP. شغّل الواجهة المحلية، أشر إلى أي خادم MCP عبر stdio/SSE/streaming-HTTP، فتحصل على قائمة الأدوات ونماذج الاستدعاء اليدوي ومحادثة مدمجة تستخدم الخادم كأدوات للعامل ومشغّل تقييم. هل تؤلف خادماً أو تصحح أخطاءه؟ استخدم هذا قبل الشحن.

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

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

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

عرض مباشر

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

mcpjam-inspector.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add mcpjam-inspector -- npx -y @mcpjam/inspector

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

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

استخدامات عملية: MCPJam Inspector

تصحيح سبب استدعاء أداة MCP بطريقة خاطئة

👤 مؤلفو خوادم MCP ⏱ ~20 min intermediate

متى تستخدمه: شحنت أداة وClaude يستمر في استدعائها بوسائط خاطئة.

المتطلبات الأساسية
  • Inspector يعمل — npx -y @mcpjam/inspector (يفتح المتصفح على localhost:6274)
  • خادم MCP الخاص بك — جهّزه للتشغيل عبر أمر stdio أو SSE URL
الخطوات
  1. الاتصال بالخادم
    In the inspector UI, add a stdio server: command=node, args=[./dist/server.js].✓ تم النسخ
    → قائمة الأدوات تظهر مع الأوصاف والمخططات
  2. قراءة ما يراه النموذج
    Look at the rendered description in the tool detail panel — that's exactly what the model sees.✓ تم النسخ
    → اكتشاف الغموض ("id" يجب أن تكون "task_id"، أو المثال مفقود)
  3. إعادة إنتاج الاستخدام الخاطئ
    Open Chat tab. Send the user prompt that caused the failure. Watch the tool_use payload.✓ تم النسخ
    → نفس الاستدعاء الخاطئ الذي رأيته في الإنتاج
  4. إصلاح الوصف وإعادة الاختبار
    Update the tool's description and example in your server code, restart, retry the same prompt.✓ تم النسخ
    → استدعاء صحيح هذه المرة

النتيجة: إصلاح ملموس مدعوم بمقارنة قبل/بعد قائمة على الأدلة.

المزالق
  • مخطط قديم مخزن مؤقتاً بعد إعادة تشغيل الخادم — انقر 'Reconnect' في لوحة الخادم؛ المفتش يعيد جلب list_tools

تقييم كيف تستخدم نماذج مختلفة أدوات خادم MCP

👤 مؤلفو الخوادم الذين يستهدفون عملاء متعددين ⏱ ~45 min advanced

متى تستخدمه: تريد معرفة هل خادمك يعمل بنفس الكفاءة مع Sonnet كما مع Haiku/GPT-5.

الخطوات
  1. بناء مجموعة تقييم
    Author 10 representative user prompts in the Eval tab. Mix easy and adversarial.✓ تم النسخ
    → تقييم محفوظ مع prompts + تسلسلات الأدوات المتوقعة
  2. التشغيل عبر النماذج
    Run the eval against Sonnet 4.6, Haiku 4.5, and GPT-5. Compare tool-use traces.✓ تم النسخ
    → تتبع لكل نموذج؛ نجاح/فشل لكل prompt
  3. تحسين أضعف مخطط
    On the failing prompts, what description change would fix the cheaper model without breaking Sonnet?✓ تم النسخ
    → إعادة كتابة وصف محددة

النتيجة: خادم يعمل عبر الطيف الكامل من النماذج، ليس فقط ذلك الذي اختبرته.

المزالق
  • التقييم يختبر المسار السعيد فقط — أضف prompts عدائية: وسائط مفقودة، مدخلات متناقضة، معلومات جزئية

استكشاف خادم MCP تابع لجهة خارجية بأمان

👤 أي شخص يقيّم خادم MCP مجتمعي ⏱ ~15 min intermediate

متى تستخدمه: تفكر في إضافة خادم MCP لأحدهم وتريد معرفة الأدوات التي يكشفها أولاً.

الخطوات
  1. تشغيله معزولاً
    Add the server in inspector — don't put it in your real client config yet.✓ تم النسخ
    → الأدوات مدرجة مع أوصاف كاملة
  2. مراجعة السطح
    Scan tool list. Anything that writes/deletes/runs code? Anything that calls external URLs?✓ تم النسخ
    → قائمة أدوات مصنفة حسب المخاطر
  3. اختبار الأدوات الخطرة يدوياً
    Hand-call each write tool with a no-op payload to see what it actually does.✓ تم النسخ
    → تأكيد السلوك قبل كشفه لعامل مستقل

النتيجة: قرار تثبيت/تخطي مستنير بدلاً من ثقة عمياء.

المزالق
  • الأداة تستدعي shell — حتى الاستدعاء اليدوي قد يُغيّر نظامك — شغّل في حاوية أو مجلد تجريبي؛ لا تفحص MCP غير موثوق على جهازك الرئيسي

التركيبات

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

mcpjam-inspector + github

تحليل خادم MCP الخاص بك في CI

On every PR, run inspector eval against the main + PR head; comment diff in the PR via github MCP.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_tools server connection يعمل تلقائياً عند الاتصال — نادراً ما يُستدعى يدوياً 0
call_tool tool_name, args استدعاء يدوي لأي أداة بمدخلات النموذج depends on tool
chat model, messages توجيه نموذج لغوي عبر أدواتك لمشاهدة السلوك الناشئ depends on model API
run_eval eval_set, models[] فحص انحدار عبر النماذج قبل الشحن API calls × models × prompts

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

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

حصة API
وضع التقييم يستهلك حصص مزودي النماذج — أحضر مفاتيحك الخاصة
الرموز لكل استدعاء
0 للمفتش نفسه؛ تكلفة عامل كاملة للمحادثة/التقييم
التكلفة المالية
مجاني (مفتوح المصدر) — تدفع فقط تكاليف API للنماذج
نصيحة
استخدم Haiku للتكرار في التقييم؛ انتقل إلى Sonnet فقط للفحص المتقاطع النهائي

الأمان

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

الحد الأدنى من الصلاحيات: شبكة محلية فقط افتراضياً
تخزين بيانات الاعتماد: مفاتيح API لنماذج التقييم مخزنة في localStorage المتصفح افتراضياً — امسحها بعد الاستخدام على الأجهزة المشتركة
نقل البيانات الخارجي: فقط إلى مزودي النماذج الذين تضبطهم (Anthropic, OpenAI, إلخ) وخوادم MCP التي تتصل بها
لا تمنح أبدًا: الوصول عبر الإنترنت العام — أبقِ المفتش على localhost

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

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

فشل الخادم في الاتصال (stdio)

تحقق أن مسار الأمر مطلق وأن مجلد العمل مضبوط؛ افحص stderr في لوحة سجلات المفتش

تحقق: شغّل أمر الخادم يدوياً في terminal أولاً
خادم SSE يتوقف عند الاتصال

مشكلة CORS أو header مصادقة — تحقق أن endpoint الـ SSE يقبل طلبات cross-origin من localhost:6274

تحقق: curl -N <sse_url> with -H 'Accept: text/event-stream'
التقييم يعمل لكن كل النماذج تفشل

تحقق من صلاحية مفتاح API في الإعدادات؛ تحقق أن أسماء النماذج تطابق تسمية المزود الحالية

منفذ المفتش مستخدم مسبقاً

PORT=6275 npx @mcpjam/inspector

تحقق: lsof -i :6274

البدائل

MCPJam Inspector مقابل البدائل

البديلمتى تستخدمهاالمقايضة
modelcontextprotocol/inspector (official)تريد المفتش المرجعي الرسمي بأكثر مجموعة ميزات محافظةيفتقر لوضعي المحادثة/التقييم؛ مستوى أدنى
wong2/mcp-cliتفضل terminal على الواجهة الرسوميةلا مقارنة تقييم مرئية ولا عرض مخطط

المزيد

الموارد

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

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

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