MCP Inspector — Debug MCP Servers Visually
Official MCP Inspector for testing and debugging MCP servers. 9.3K+ stars. Web UI, tool/resource/prompt inspection, request testing.
What it is
MCP Inspector is the official visual testing and debugging tool for Model Context Protocol (MCP) servers. It provides a web UI where you connect to any MCP server and inspect its tools, resources, and prompts. You can test individual tool calls, view request/response payloads, and debug connection issues without writing code.
MCP Inspector targets MCP server developers and anyone integrating MCP tools into AI agents. It serves as the debugging companion during development, letting you verify server behavior before connecting it to Claude Code or other agents.
How it saves time or tokens
Without MCP Inspector, debugging MCP servers requires reading logs, crafting JSON requests manually, or connecting a full AI agent to test each tool. MCP Inspector provides instant visual feedback: see all available tools, click to test them, and inspect the responses. This shortens the debug cycle from minutes to seconds.
How to use
- Run MCP Inspector with
npx @modelcontextprotocol/inspector. - Open the web UI at
http://localhost:6274. - Connect to your MCP server and inspect tools, resources, and prompts.
Example
# Start MCP Inspector
npx @modelcontextprotocol/inspector
# Opens web UI at http://localhost:6274
# Connect to your MCP server (stdio or HTTP)
# Example: inspect a filesystem MCP server
npx @modelcontextprotocol/inspector -- npx @modelcontextprotocol/server-filesystem /tmp
| Feature | Description |
|---|---|
| Tool inspection | List all tools with schemas |
| Request testing | Call tools with custom parameters |
| Resource browsing | View available resources |
| Prompt listing | Inspect prompt templates |
| Connection debug | Diagnose connection issues |
Related on TokRepo
- MCP Chrome — Chrome browser MCP integration
- MCP GitHub — GitHub MCP server
Common pitfalls
- MCP Inspector connects via stdio by default. If your server uses HTTP transport, configure the connection type in the UI.
- The inspector runs on port 6274. Ensure no other service occupies this port before starting.
- MCP Inspector shows the raw MCP protocol. Understanding the MCP specification helps interpret the tool schemas and request formats.
Frequently Asked Questions
MCP (Model Context Protocol) is a standard for connecting AI agents to external tools and data sources. MCP servers expose tools, resources, and prompts that AI agents can call. MCP Inspector helps you debug these servers.
Yes. MCP Inspector connects to any MCP-compliant server regardless of implementation language. It supports stdio and HTTP transport modes.
No. Use npx to run it directly without global installation. Each invocation downloads the latest version automatically.
Yes. When you test a tool in the inspector, it executes the actual tool call on the server. Be careful when testing tools that modify data (write, delete) on production servers.
Yes. MCP Inspector is maintained under the @modelcontextprotocol npm scope, the same organization that maintains the MCP specification and reference servers.
Citations (3)
- MCP Inspector GitHub— MCP Inspector is the official debugging tool for MCP servers
- MCP Specification— Model Context Protocol specification
- MCP Documentation— MCP server development and testing
Related on TokRepo
Source & Thanks
- GitHub: https://github.com/modelcontextprotocol/inspector (9.3K+ stars)
- License: Open Source (Model Context Protocol team)
- Part of the official MCP ecosystem