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

> Open-source, self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.

# Welcome to MCPHub

MCPHub is an open-source, self-hosted MCP gateway and control plane that helps you connect, control, route, and operate multiple MCP servers through unified endpoints.

## 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/2BJehJZVH5">
    Join our community discussions
  </Card>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.