🚀 StreamHub MCP

StreamHub MCP é um servidor MCP (Model Context Protocol) de código aberto que permite a qualquer agente de inteligência artificial (como Google Antigravity, Claude Desktop, Cursor ou ChatGPT) configurar e disparar lives simultâneas no YouTube Live, Twitch e Kick.

Basta jogar a thumbnail no chat e dizer o tema da transmissão (ex: "Vou jogar Hollow Knight com @fulano e link de parceiro X"). O agente:

1. 🖼️ Analisa a imagem e o tema.

2. 🎮 Detecta o jogo oficial na Twitch e na Kick para garantir que você apareça na categoria correta.

3. 🏷️ Gera tags de SEO otimizadas para o YouTube (respeitando o limite de 500 caracteres).

4. 📄 Monta a descrição usando seus templates em Markdown (.md), incluindo suas redes sociais e apoiadores.

5. ⚡ Configura as 3 plataformas de uma vez para você só clicar em "Iniciar Transmissão" no OBS.

🔒 100% Seguro e Local (Privacidade Total)

• Zero servidores centrais ou bancos de dados na nuvem: o código roda inteiramente no seu computador.

• Suas credenciais e tokens ficam salvos exclusivamente na sua máquina em ~/.stream-hub/ com permissão restrita de acesso (chmod 600).

• Total conformidade com LGPD / GDPR.

Related MCP server: youtube-live-mcp

📦 Como Instalar

Você pode instalar o StreamHub de duas formas:

Opção 1: Instalação via Plugin (Recomendada para Antigravity / AGY)

No seu terminal ou chat com o agente:

# Instalação automática do plugin
agy plugin install cristianodmtsb/stream-hub-mcp

(Ou simplesmente clone na pasta global de plugins: git clone git@github.com:cristianodmtsb/stream-hub-mcp.git ~/.gemini/config/plugins/stream-hub)

Ao fazer isso:

• O Antigravity descobre o plugin automaticamente em ~/.gemini/config/plugins/stream-hub/.

• O servidor MCP e a skill do agente são ativados imediatamente.

Opção 2: Instalação Manual (Para Claude Desktop, Cursor ou Desenvolvimento)

# 1. Clone o repositório onde preferir
git clone git@github.com:cristianodmtsb/stream-hub-mcp.git
cd stream-hub-mcp

# 2. Instale as dependências e compile o TypeScript
npm install
npm run build

📂 Onde ficam salvos os arquivos e como editar?

Para garantir segurança e para que você nunca perca suas configurações ao atualizar o plugin, os arquivos são separados em dois lugares:

💡 Como editar seus templates:
Basta abrir o arquivo ~/.stream-hub/templates/default.md no VS Code ou Bloco de Notas. Ele sempre terá prioridade sobre os templates padrão do repositório!

⚡ Autenticação Direta pelo Chat (Zero Terminal)

Se você instalou como plugin ou MCP, não precisa abrir o terminal ou caçar IDs numéricos: Basta dizer no chat:

• 💬 Twitch: "Conectar Twitch" ou /auth-twitch (abre o navegador e detecta seu canal e ID da Twitch sozinho).

• 💬 YouTube: "Conectar YouTube" ou /auth-youtube (abre o navegador e detecta o ID do seu canal do YouTube sozinho).

• 💬 Kick: "Conectar Kick" ou /auth-kick (informa seu canal e chave; o StreamHub verifica e vincula o canal oficial sozinho).

O agente chamará a ferramenta de autenticação, abrirá o navegador ou salvará as chaves automaticamente na sua máquina (~/.stream-hub/config.json).

(O comando de terminal node dist/bin/cli.js auth <platform> continua disponível como alternativa caso prefira).

📖 Guias Detalhados

• 🔑 Guia de Autenticação e Credenciais (YouTube, Twitch, Kick): Passo a passo simples com links para obter suas chaves de API sem dor de cabeça.

• 📝 Guia de Templates em Markdown (.md): Como editar sua descrição padrão, adicionar redes sociais e patrocinadores.

• 🖼️ Guia de Thumbnails: Como enviar imagens no chat e recomendações para YouTube/Twitch.

• 🛠️ Como Contribuir com Novas Plataformas: Como adicionar adaptadores para TikTok, Instagram, Bilibili, etc.

🤖 Como Conectar ao Antigravity / Claude Desktop

Adicione ao seu arquivo de configuração de MCP (ex: mcpSettings.json ou claude_desktop_config.json):

{
  "mcpServers": {
    "stream-hub": {
      "command": "node",
      "args": ["/caminho/absoluto/para/stream-hub-mcp/dist/index.js"]
    }
  }
}

💬 Comandos Rápidos no Chat (Zero Terminal)

Você pode gerenciar tudo diretamente na conversa com o agente:

🧪 (Opcional) Comandos de Terminal / CLI

Caso prefira rodar comandos diretamente no terminal:

# Verificar status das plataformas conectadas
node dist/bin/cli.js status

# Autenticar plataformas via terminal
node dist/bin/cli.js auth youtube
node dist/bin/cli.js auth twitch
node dist/bin/cli.js auth kick

📄 Licença

Distribuído sob a licença MIT. Contribuições da comunidade são muito bem-vindas!