/ الدليل / الملعب / MCP Inspector
● رسمي modelcontextprotocol ⚡ فوري

MCP Inspector

بواسطة modelcontextprotocol · modelcontextprotocol/inspector

The official debugger for MCP servers — connect to any server, call its tools live, see the raw protocol traffic.

MCP Inspector is the canonical dev tool for MCP. Point it at a server (local or remote), enumerate tools and resources, fire calls with structured inputs, and watch frames go by. First thing to reach for when your server misbehaves.

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Debug your MCP server without involving an LLM

👤 Developers ⏱ ~15 min intermediate

متى تستخدمه: Claude says 'tool failed' and you need to see what really happened.

الخطوات
  1. Launch
    npx @modelcontextprotocol/inspector ./my-server.✓ تم النسخ
    → UI opens
  2. Invoke
    Pick the tool; fill inputs; send.✓ تم النسخ
    → Result + frames shown
  3. Diagnose
    Toggle raw frames to see protocol-level errors.✓ تم النسخ
    → Root cause clear

النتيجة: Server bug isolated without LLM noise.

التركيبات

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

mcp-inspector + fastmcp-prefect

Build a FastMCP server; debug it with the Inspector before shipping

Combine mcp-inspector with fastmcp-prefect: Build a FastMCP server; debug it with the Inspector before shipping✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
tools.call (see docs) Invoke any tool the server advertises 1 call
resources.list (see docs) Browse resources 1 call

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

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

حصة API
N/A
الرموز لكل استدعاء
N/A
التكلفة المالية
Free OSS
نصيحة
Save common invocations as bookmarks

الأمان

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

تخزين بيانات الاعتماد: Local only
نقل البيانات الخارجي: Whatever the server reaches
لا تمنح أبدًا: Run untrusted MCP servers against your auth tokens

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

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

Server won't connect

Check transport (stdio vs SSE); confirm the binary path

البدائل

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

البديلمتى تستخدمهاالمقايضة
mcp2cliYou prefer command-lineNo GUI for protocol inspection

المزيد

الموارد

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

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

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