Installation Guide

# Pull the latest image
docker pull samanhappy/mcphub:latest

# Run with default settings
docker run -d \
  --name mcphub \
  -p 3000:3000 \
  samanhappy/mcphub:latest

# Create your configuration file
cat > mcp_settings.json << 'EOF'
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    }
  }
}
EOF

# Run with mounted config
docker run -d \
  --name mcphub \
  -p 3000:3000 \
  -v $(pwd)/mcp_settings.json:/app/mcp_settings.json \
  samanhappy/mcphub:latest

docker run -d \
  --name mcphub \
  -p 3000:3000 \
  -e PORT=3000 \
  -e BASE_PATH="" \
  samanhappy/mcphub:latest

version: '3.8'
services:
  mcphub:
    image: samanhappy/mcphub:latest
    ports:
      - "3000:3000"
    volumes:
      - ./mcp_settings.json:/app/mcp_settings.json
    environment:
      - PORT=3000
      - BASE_PATH=""
      - REQUEST_TIMEOUT=60000
    restart: unless-stopped

  # Optional: PostgreSQL for Smart Routing
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_DB: mcphub
      POSTGRES_USER: mcphub
      POSTGRES_PASSWORD: mcphub_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  postgres_data:

docker-compose up -d

# Run PostgreSQL with pgvector
docker run -d \
  --name mcphub-postgres \
  -e POSTGRES_DB=mcphub \
  -e POSTGRES_USER=mcphub \
  -e POSTGRES_PASSWORD=your_password \
  -p 5432:5432 \
  pgvector/pgvector:pg16