> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcphub.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCPHub

> The Unified Hub for Model Context Protocol (MCP) Servers

# Welcome to MCPHub

MCPHub makes it easy to manage and scale multiple MCP (Model Context Protocol) servers by organizing them into flexible Streamable HTTP (SSE) endpoints—supporting access to all servers, individual servers, or logical server groups.

## Key Features

<CardGroup cols={2}>
  <Card title="Unified Management" icon="server" href="/features/server-management">
    Centrally manage multiple MCP servers with hot-swappable configuration
  </Card>

  <Card title="Group Management" icon="users" href="/features/group-management">
    Organize servers into logical groups for streamlined access control
  </Card>

  <Card title="Smart Routing" icon="route" href="/features/smart-routing">
    AI-powered tool discovery using vector semantic search
  </Card>

  <Card title="Tool Result Compression" icon="file-text" href="/configuration/mcp-settings#tool-result-compression">
    Transparently reduce large text tool outputs before they reach clients
  </Card>

  <Card title="Real-time Monitoring" icon="chart-line" href="/features/monitoring">
    Monitor server status and performance from a unified dashboard
  </Card>
</CardGroup>

## Quick Start

Get MCPHub running in minutes with Docker:

```bash theme={null}
docker run -p 3000:3000 samanhappy/mcphub
```

Or with custom configuration:

```bash theme={null}
docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub
```

Access the dashboard at `http://localhost:3000` with username `admin`. On first launch, a random password is generated and printed to the server logs. Set `ADMIN_PASSWORD` env var to use a custom password.

## Core Concepts

### MCP Endpoints

MCPHub provides multiple ways to access your MCP servers:

* **Unified Access**: `http://localhost:3000/mcp` - Access all servers
* **Group Access**: `http://localhost:3000/mcp/{group}` - Access specific groups
* **Server Access**: `http://localhost:3000/mcp/{server}` - Access individual servers
* **Smart Routing**: `http://localhost:3000/mcp/$smart` - AI-powered tool discovery

### Protocol Support

* **HTTP MCP**: Modern streamable HTTP interface (recommended)
* **SSE**: Server-Sent Events for legacy compatibility
* **stdio**: Native MCP protocol for server communication

## Getting Started

<CardGroup cols={2}>
  <Card title="Quick Start Guide" icon="rocket" href="/quickstart">
    Get MCPHub running in 5 minutes
  </Card>

  <Card title="Installation Guide" icon="download" href="/installation">
    Detailed installation instructions for all platforms
  </Card>

  <Card title="Configuration" icon="cog" href="/configuration/mcp-settings">
    Learn how to configure your MCP servers
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Complete API documentation
  </Card>
</CardGroup>

## Community & Support

<CardGroup cols={3}>
  <Card title="GitHub" icon="github" href="https://github.com/samanhappy/mcphub">
    Source code and issue tracking
  </Card>

  <Card title="Discord" icon="discord" href="https://discord.gg/c8GKyzyFF">
    Join our community discussions
  </Card>

  <Card title="Sponsor" icon="heart" href="https://ko-fi.com/samanhappy">
    Support the project development
  </Card>
</CardGroup>