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.
| 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. |
LLM Playground
Connect to any server
Start up the MCPJam inspector:
npx @mcpjam/inspector@latestOther 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.2Run 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:latestThe application will be available at http://localhost:3001.
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
- 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
# Clone the repository
git clone https://github.com/mcpjam/inspector.git
cd inspector
# Install dependencies
npm install
# Start development server
npm run devThe development server will start at http://localhost:3000 with hot reloading enabled.
# Build the application
npm run build
# Start production server
npm run start| 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 |
We welcome contributions to MCPJam Inspector V1! Please read our CONTRIBUTING.md for development guidelines and best practices.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Develop your changes with proper testing
- Format code with
npm run prettier-fix - Lint code with
npm run lint - Commit your changes (
git commit -m 'Add amazing feature') - Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request
- 💬 Discord: Join the MCPJam Community
- 📖 MCP Protocol: Model Context Protocol Documentation
- 🔧 Mastra Framework: Mastra MCP Integration
- 🤖 AI SDK: Vercel AI SDK
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
