inspector

A developer tool for testing, debugging Model Context Protocol (MCP) servers. Test whether or not you built your MCP server correctly. The project is open source and fully compliant to the MCP spec.

Key Features

Feature	Description
Full MCP Spec Compliance	Test your MCP server's tools, resources, prompts, elicitation, and OAuth 2. MCPJam is compliant with the latest MCP specs.
All transports supported	Connect to any MCP server. MCPJam inspector supports STDIO, SSE, and Streamable HTTP transports.
LLM Playground	Integrated chat playground with OpenAI, Anthropic Claude, and Ollama model support. Test how your MCP server would behave against an LLM
Debugging	Comprehensive logging, tracing, and error reporting for MCP server development
Developer Experience	Connect to multiple MCP servers. Save configurations. Upgraded UI/UX for modern dev experience.

📸 Screenshots

LLM Playground

Connect to any server

🚀 Quick Start

Start up the MCPJam inspector:

npx @mcpjam/inspector@latest

Other commands:

# Launch with custom port
npx @mcpjam/inspector@latest --port 4000

# Shortcut for starting MCPJam and an Ollama model
npx @mcpjam/inspector@latest --ollama llama3.2

🐳 Docker

Run MCPJam Inspector using Docker:

# Run the latest version from Docker Hub
docker run -p 3001:3001 mcpjam/mcp-inspector:latest

# Or run in the background
docker run -d -p 3001:3001 --name mcp-inspector mcpjam/mcp-inspector:latest

The application will be available at http://localhost:3001.

Connecting to MCP servers

mcp.json

You can import your mcp.json MCP server configs from Claude Desktop and Cursor with the command:

npx @mcpjam/inspector@latest --config mcp.json

STDIO

Note: Always use global file paths

# Local FastMCP STDIO example
npx @mcpjam/inspector@latest uv run fastmcp run /Users/matt8p/demo/src/server.py
# Local Node example
npx @mcpjam/inspector@latest npx -y /Users/matt8p/demo-ts/dist/index.js

SSE / Streamable HTTP

Spin up the MCPJam inspector

npx @mcpjam/inspector@latest

In the UI "MCP Servers" tab, click add server, select HTTP, then paste in your server URL

Requirements

🏗️ Architecture

MCPJam Inspector V1 is built as a modern Next.js application with integrated MCP capabilities:

📦 @mcpjam/inspector-v1
├── 🎨 src/app/              # Next.js 15 App Router
├── 🧩 src/components/       # React components with Radix UI
├── 🔧 src/lib/             # Utility functions and helpers
├── 🎯 src/hooks/           # Custom React hooks
├── 📱 src/stores/          # Zustand state management
├── 🎨 src/styles/          # Tailwind CSS themes
└── 🚀 bin/                # CLI launcher script

Tech Stack

• Framework: Next.js 15.4 with App Router and React 19
• Styling: Tailwind CSS 4.x with custom themes and Radix UI components
• MCP Integration: Mastra framework (@mastra/core, @mastra/mcp)
• AI Integration: AI SDK with OpenAI, Anthropic, and Ollama providers

---

🛠️ Development

Local Development Setup

# Clone the repository
git clone https://github.com/mcpjam/inspector.git
cd inspector

# Install dependencies
npm install

# Start development server
npm run dev

The development server will start at http://localhost:3000 with hot reloading enabled.

Build for Production

# Build the application
npm run build

# Start production server
npm run start

Available Scripts

Script	Description
npm run dev	Start Next.js development server with Turbopack
npm run build	Build the application for production
npm run start	Start the production server
npm run lint	Run ESLint code linting
npm run prettier-fix	Format code with Prettier

---

🤝 Contributing

We welcome contributions to MCPJam Inspector V1! Please read our CONTRIBUTING.md for development guidelines and best practices.

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Develop your changes with proper testing
4. Format code with npm run prettier-fix
5. Lint code with npm run lint
6. Commit your changes (git commit -m 'Add amazing feature')
7. Push to your branch (git push origin feature/amazing-feature)
8. Open a Pull Request

📚 Resources

• 💬 Discord: Join the MCPJam Community
• 📖 MCP Protocol: Model Context Protocol Documentation
• 🔧 Mastra Framework: Mastra MCP Integration
• 🤖 AI SDK: Vercel AI SDK

---

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

---