⚠️ This is a read-only mirror of libraries/typescript/packages/inspector in the mcp-use/mcp-use monorepo.

🚀 Please submit issues and pull requests to the monorepo instead.

🛠 This branch mirrors: canary

🌐 Source folder: libraries/typescript/packages/inspector

<div align="center" style="margin: 0 auto; max-width: 80%;"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mcp-use/mcp-use/main/static/logo_white.svg"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mcp-use/mcp-use/main/static/logo_black.svg"> <img alt="mcp use logo" src="https://raw.githubusercontent.com/mcp-use/mcp-use/main/static/logo_white.svg" width="80%" style="margin: 20px auto;"> </picture> </div> <h1 align="center">MCP Inspector</h1> <p align="center"> <a href="https://www.npmjs.com/package/@mcp-use/inspector" alt="NPM Downloads"> <img src="https://img.shields.io/npm/dw/@mcp-use/inspector.svg"/></a> <a href="https://www.npmjs.com/package/@mcp-use/inspector" alt="NPM Version"> <img src="https://img.shields.io/npm/v/@mcp-use/inspector.svg"/></a> <a href="https://github.com/mcp-use/mcp-use/blob/main/LICENSE" alt="License"> <img src="https://img.shields.io/github/license/mcp-use/mcp-use" /></a> <a href="https://github.com/mcp-use/mcp-use/stargazers" alt="GitHub stars"> <img src="https://img.shields.io/github/stars/mcp-use/mcp-use?style=social" /></a> <a href="https://discord.gg/XkNkSkMz3V" alt="Discord"> <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a> </p>

🔍 MCP Inspector by mcp-use is an open-source, interactive developer tool for testing and debugging MCP servers with support for MCP-UI and OpenAI Apps SDK widgets. It provides a beautiful, intuitive interface for testing tools, exploring resources, managing prompts, and monitoring server connections - all from your browser.

🚀 Try it:

Online: inspector.mcp-use.com
Locally: Run npx @mcp-use/inspector
Repository: github.com/mcp-use/mcp-use

🎥 Demo

📖 Documentation

For detailed usage instructions and guides, visit mcp-use.com/docs/inspector

📦 Related Packages

| Package | Description | Version | | ------------------------------------------------------------------------------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------- | | mcp-use | Core MCP framework | | | @mcp-use/cli | Build tool for MCP apps | | | create-mcp-use-app | Create MCP apps | |

✨ Key Features

| Feature | Description | | -------------------------- | ------------------------------------------------------------------ | | 🚀 Auto-Mount | Automatically available at /inspector for all mcp-use servers | | 🔌 Multi-Connection | Connect to and manage multiple MCP servers simultaneously | | 🎯 Interactive Testing | Test tools with live execution and real-time results | | 📊 Real-time Status | Monitor connection states, errors, and server health | | 🔐 OAuth Support | Built-in OAuth flow handling with popup authentication | | 💾 Persistent Sessions | Connections saved to localStorage and auto-reconnect | | 🎨 Beautiful UI | Modern, responsive interface built with React and Tailwind | | 🔍 Tool Explorer | Browse and execute all available tools with schema validation | | 📁 Resource Browser | View and copy resource URIs with syntax highlighting | | 💬 Prompt Manager | Test and manage prompts with argument templates | | 🌐 Universal Support | Works with HTTP/SSE and WebSocket connections | | 🎨 Widget Support | Full support for MCP-UI and OpenAI Apps SDK widgets | | 🔑 BYOK Chat | Bring Your Own Key chat interface for testing conversational flows | | 💾 Saved Tool Calls | Save and replay tool executions for repeated testing | | ⌨️ Quick Actions | Cmd + K keyboard shortcuts for rapid navigation | | 🐳 Docker Ready | Self-host with a single Docker container for production use |

🚀 Quick Start

Access the Inspector

There are three ways to use the MCP Inspector:

1. Online Version (Recommended for Testing)

Visit inspector.mcp-use.com - no installation required!

2. Run Locally

npx @mcp-use/inspector

Opens the inspector in your browser at http://localhost:8080

3. Auto-mounted with mcp-use Servers

When you create an MCP server with mcp-use, the inspector is automatically available at /inspector:

import { MCPServer } from "mcp-use/server";

const server = new MCPServer({
  name: "my-server",
  version: "1.0.0",
});

// Add your tools, resources, prompts...

server.listen(3000);
// 🎉 Inspector automatically available at http://localhost:3000/inspector

📖 Usage Guide

Dashboard

The main dashboard is your central hub for managing MCP server connections:

Connected Servers Panel (left): View all your connected servers
Connect Panel (right): Add new server connections with transport, URL, auth, and headers configuration
Quick Actions: Access settings and clear sessions from the top bar

Adding an MCP Server

To connect to an MCP server:

Open Connect Panel: Click the Connect panel on the right side of the dashboard
Configure Transport:
- Select "Streamable HTTP" for SSE connections
- Select "WebSocket" for WS connections
- Configure "stdin/stdio" for local process connections
Enter Server URL: Input the MCP server endpoint (e.g., https://mcp.linear.app/mcp)
Configure Authentication (if needed): Add OAuth credentials or API headers
Click Connect: Establish the connection

Example URLs:

Linear: https://mcp.linear.app/mcp
Local: http://localhost:3000/mcp

OAuth Authentication

For servers requiring OAuth (like Linear):

After clicking Connect, you'll see the authorization page
Click "Approve" to grant access
The inspector handles the redirect automatically
Server appears in Connected Servers list with a green indicator

Privacy Note: All authentication tokens and credentials are stored securely in your browser's local storage. Nothing is sent to our servers - everything stays on your device.

Connected Servers

Once connected, each server shows:

Connection status indicator (green = connected)
Server name and URL
Available tools count
Action buttons: Inspect, Disconnect, Remove

Click "Inspect" to open the detailed server view.

🔍 Server Detail View

After clicking "Inspect" on a connected server, you'll see four main tabs:

Tools Tab

The Tools tab displays all available tools from the MCP server.

Features:

Browse all available tools with their names and descriptions
Select a tool to view its detailed schema
Click "Execute" to test the tool
Enter JSON parameters in the input panel
View real-time results with syntax highlighting
Support for MCP-UI and OpenAI Apps SDK widgets

Example: When connected to Linear MCP server, you'll see 23+ tools for managing issues, projects, and teams.

Resources Tab

Browse available resources from the MCP server:

View resource descriptions and metadata
Copy resource URIs for use in your applications
Check MIME types and resource properties
Preview resource content

Note: Some servers (like Linear) may not expose resources, in which case you'll see "No resources available".

Prompts Tab

Test and manage pre-configured prompts:

View all available prompts with descriptions
Select a prompt to see its schema
Fill in required arguments in the form
Click "Render" to execute the prompt
Copy the rendered output for use

Note: Not all servers provide prompts. If none are available, you'll see "No prompts available".

Elicitation Tab

The Elicitation tab handles tool requests that require user input during execution.