// agents · samanhappy/mcphub

mcphub

mcphub é um projeto de agentes de IA de código aberto de samanhappy (samanhappy/mcphub no GitHub). Tem 2.503 estrelas no GitHub e 331 forks, é publicado sob a licença Apache-2.0 e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

Self-hosted MCP gateway and control plane — connect, control and operate all your MCP servers from one place

★ 2,5 mil estrelas⑂ 331 forksApache-2.0atualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Repositório
samanhappy/mcphub
Estrelas no GitHub
2.503
Forks
331
Licença
Apache-2.0
Última atualização no GitHub
8 de outubro de 2026
Categoria
Agentes de IA
Tipo de ficha
Guia de instalação completo
Site oficial
Official site
// como funciona

Como funciona

  1. Clarify your goal

    List the MCP servers your team uses and who should see which servers, groups and tools.

  2. Get MCPHub

    Run the Docker image with a ./data volume for persistence (or clone for local development with pnpm).

  3. Install and configure

    Optionally pre-create data/mcp_settings.json with your servers, set ADMIN_PASSWORD, then log in to the dashboard as admin and finish setup.

  4. Connect your clients

    Point clients at http://localhost:3000/mcp (or /mcp/{group}, /mcp/{server}, /mcp/$smart) and verify tool calls flow through the hub.

// recursos

Por que as pessoas gostam tanto

Unified gateway endpoints

Stable MCP endpoints for all servers, a group, a single server, or smart routing scoped to a group.

Smart routing

AI-powered tool discovery using vector semantic search, so clients find the right tool across many servers.

Per-user credentials

Bind personal keys to one shared server with encrypted storage and isolated stdio runtimes per user.

Auth and visibility

OAuth 2.0 (client and server modes), bearer tokens, GitHub/Google social login (database mode), and per-server/group visibility of tools, prompts and resources.

Operations built in

Tool-call logs with status and latency, server log inspection, health checks, hot-swappable config and tool-result compression.

Production options

PostgreSQL database mode, a full Docker image variant with Rust/Playwright for heavier servers, and a headless mode without the dashboard.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repo

    Clone MCPHub for local development; the fastest run path is Docker in step 2.

    git clone https://github.com/samanhappy/mcphub.git
    cd mcphub
  2. Run with Docker

    Start MCPHub on port 3000 with persistent data, as the quick start shows.

    docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub
  3. Open the dashboard

    Log in at http://localhost:3000 as admin (set ADMIN_PASSWORD, or read the generated password from the server logs on first launch), add servers, and connect clients to /mcp.

    # open http://localhost:3000
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains MCPHub?

samanhappy maintains it; site and demo are at mcphub.app, docs at docs.mcphub.app.

Is MCPHub free?

Yes, Apache-2.0 licensed and self-hosted. The README offers optional paid production support from the maintainer.

Does it need a paid API key?

No — you run it yourself. The MCP servers behind it keep their own credentials, which MCPHub stores encrypted per user.

How does it compare to MetaMCP?

Both aggregate MCP servers behind endpoints. MetaMCP centers on namespaces/middleware; MCPHub centers on the control plane — per-user credentials, smart routing, logs and health monitoring.

How do I get started?

Run the docker run command, open http://localhost:3000, log in as admin, add a server in the dashboard, and connect your client to /mcp.

// continue explorando

Ferramentas semelhantes

Agentes de IA

metamcp

MCP aggregator, orchestrator, middleware and gateway in one Docker — compose many servers into one endpoint

★ 2,7 mil estrelasMIT
Ver o guia →
Agentes de IA

Unla

Unla MCP Gateway: turn existing APIs and MCP servers into MCP endpoints with zero code changes.

★ 2,2 mil estrelasMIT
Ver o guia →
Agentes de IA

yao

All your agents and workspaces in one place — on every device you own.

★ 8,1 mil estrelasNOASSERTION
Ver o guia →
Agentes de IA

nanobot

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat…

★ 48,8 mil estrelasMIT
Ver o guia →
Agentes de IA

zotero-mcp

Connect your Zotero research library to Claude and other AI assistants through MCP.

★ 5,3 mil estrelasMIT
Ver o guia →
Agentes de IA

lamda

FIRERPA / LAMDA — full-stack Android device control: remote desktop, automation, MITM, Frida and MCP.

★ 8,6 mil estrelasMIT
Ver o guia →
// alternativas

Alternativas em Agentes de IA

Os outros projetos de Agentes de IA com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se mcphub não for o ideal para você.

// mais em agents

Mais em Agentes de IA

Projetos de Agentes de IA próximos no catálogo, os mais próximos em estrelas de mcphub: continue explorando dos dois lados dele.

Baixe o mcphub

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.