Skip to main content

​
Quick start

Run the command in your terminal 
npx @mcpjam/inspector@latest
After installing the package, you should see a link to localhost. Open that link up to see the inspector.

​
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.

​
Start with STDIO server

This will open the MCPJam inspector and connect to a STDIO using the commands you provided.
  • Python Server
  • Node.js Server
# Starts MCPJam inspector with a FastMCP server
npx @mcpjam/inspector@latest uv run fastmcp run /path/to/your/server.py
Use Absolute Paths: Always use absolute file paths (e.g., /Users/yourname/project/server.py) to avoid path resolution issues.

​
Start with custom port

This will start the MCPJam inspector with a custom port number. The default port is 6274. 
npx @mcpjam/inspector@latest --port 4000

​
Start with Ollama

This will open the MCPJam inspector and start an Ollama model with the ollama serve <model> command. Make sure you have Ollama installed. 
npx @mcpjam/inspector@latest --ollama llama3.2

​
Start with Configuration File

You can use a configuration file to connect to multiple MCP servers at once: 
# Using npx directly
npx @mcpjam/inspector@latest --config path/to/config.json --server myserver

# If running from the repository
npm run build
npm start -- --config path/to/config.json --server myserver
Note: When using npm start, you need the -- separator to pass arguments to the underlying script.
Example configuration file structure: 
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"],
      "env": {
        "HELLO": "Hello MCP!"
      }
    },
    "weather-server": {
      "command": "python",
      "args": ["weather_server.py"],
      "env": {
        "WEATHER_API_KEY": "your-api-key"
      }
    }
  }
}