Prerequisites

Before you begin, ensure you have the following installed:

  • .NET 9 SDK or later
  • A modern web browser (Chrome, Edge, Firefox, or Safari)
  • Git (optional, for cloning the repository)

Installation Methods

  1. Clone the repository

    1
2

    git clone https://github.com/garrardkitchen/mcp-explorer.git
cd mcp-explorer

  2. Restore dependencies

    1

    dotnet restore

  3. Build the application

    1

    dotnet build

  4. Run the application

    1

    dotnet run --project src/Garrard.Mcp.Explorer

  5. Open your browser

    Navigate to the URL displayed in the terminal, typically:

    • HTTPS: https://localhost:5001
    • HTTP: http://localhost:5000

    info: First Run: You may be prompted to accept the development HTTPS certificate. This is normal for local development.

Method 2: Docker (Production)

Run MCP Explorer using the pre-built Docker image:

1

docker run -p 8080:8080 garrardkitchen/mcp-explorer:latest

Then open your browser to http://localhost:8080

Custom port mapping:

1

docker run -p 5001:8080 garrardkitchen/mcp-explorer:latest

Verify Installation

After starting the application, you should see:

  1. Console output showing the application has started
  2. Web interface when you navigate to the local URL
  3. Navigation tabs for Connections, Tools, Prompts, Resources, etc.

Expected Console Output 

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:5001
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5000
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Next Steps

Troubleshooting

Port Already in Use

If port 5001 or 5000 is already in use:

1
2

# Specify a different port
dotnet run --urls "https://localhost:7001;http://localhost:7000"

Certificate Trust Issues

On first run, trust the development certificate:

1

dotnet dev-certs https --trust

Build Errors

Ensure you’re using .NET 9 SDK or later:

1

dotnet --version

For more help, see the Troubleshooting Guide.