> ## Documentation Index
> Fetch the complete documentation index at: https://mcpjam-include-cli-start.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Here's a list of all ways to start MCPJam

## Quick start

Run the command in your terminal

```bash
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:

```bash
# 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.

<Tabs>
  <Tab title="Python Server">
    ```bash
    # Starts MCPJam inspector with a FastMCP server
    npx @mcpjam/inspector@latest uv run fastmcp run /path/to/your/server.py
    ```
  </Tab>

  <Tab title="Node.js Server">
    ```bash
    # NPX package
    npx @mcpjam/inspector@latest npx -y your-mcp-package

    # Direct Node.js execution
    npx @mcpjam/inspector@latest node /path/to/your/server.js
    ```
  </Tab>
</Tabs>

<Info>
  **Use Absolute Paths**: Always use absolute file paths (e.g., `/Users/yourname/project/server.py`) to avoid path resolution issues.
</Info>

## Start with custom port

This will start the MCPJam inspector with a custom port number. The default port is `6274`.

```bash
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.

```bash
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:

```bash
# 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
```

<Info>
  **Note**: When using `npm start`, you need the `--` separator to pass arguments to the underlying script.
</Info>

Example configuration file structure:

```json
{
  "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"
      }
    }
  }
}
```
