
Criei um registro e proxy de servidor MCP auto-hospedado em TypeScript
O registro oficial do MCP é escrito em Go e hospedado na nuvem.
Eu queria algo que pudesse ser auto-hospedado, escrito em TypeScript,
que minha equipe pudesse executar dentro de nossa própria infraestrutura.
Então eu construí mcp-hub.
O que ele faz
- Registrar qualquer servidor MCP (transporte SSE, HTTP, stdio)
- Proxy todas as chamadas de ferramentas através de um único endpoint com encaminhamento de autenticação
- Transmitir cada chamada de ferramenta ao vivo via WebSocket (Socket.io)
- Monitorar a saúde do servidor de forma assíncrona via jobs do BullMQ
Stack
- NestJS — framework de API
- PostgreSQL — registro de servidores + logs de chamadas de ferramentas
- Redis — pub/sub do WebSocket + transporte do BullMQ
- BullMQ — fila de verificação de saúde assíncrona
- Socket.io — streaming de logs em tempo real
Como funciona
Registre um servidor uma vez:
curl -X POST http://localhost:3000/api/v1/servers \
-H 'Content-Type: application/json' \
-d '{
"name": "github-mcp",
"url": "http://my-mcp-server:8080",
"transport": "http"
}'
Então faça proxy de qualquer chamada de ferramenta através do mcp-hub:
curl -X POST http://localhost:3000/api/v1/proxy/{serverId}/call \
-H 'Content-Type: application/json' \
-d '{ "tool": "create_issue", "input": { "title": "Bug" } }'
Cada chamada é registrada no PostgreSQL e transmitida ao vivo via WebSocket.
Execute em um comando
git clone https://github.com/DIYA73/mcp-hub
cd mcp-hub
cp .env.example .env
docker compose up
API em http://localhost:3000/api/v1
WebSocket em ws://localhost:3000/logs
Por que eu construí isso
Estou executando vários servidores MCP localmente e precisava de um local central
para registrá-los, encaminhar chamadas e ver o que está acontecendo
em tempo real. Nada nativo em TypeScript existia.
GitHub: https://github.com/DIYA73/mcp-hub
Feedback é bem-vindo — especialmente se você estiver executando servidores MCP em produção.
A implementação de um registro MCP auto-hospedado pode beneficiar empresas brasileiras que desejam maior controle sobre suas infraestruturas de servidores. Isso pode facilitar a integração de ferramentas e melhorar a monitorização em tempo real, aumentando a eficiência operacional.
