Attendee MCP Server

Um servidor MCP para gerenciar bots de reunião do Attendee, que requer um serviço backend do Attendee em execução.

Documentação

Servidor MCP de Participantes

Este é um MCP para enviar e gerenciar bots de reunião com Attendee, um bot de reunião de código aberto para gravação e transcrição. Você pode executar o Attendee localmente ou implantá-lo na nuvem.

Dúvidas? Junte-se ao Slack do Attendee.

Início Rápido: O que você pode fazer com este MCP?

Usando o Claude como exemplo: Você pode digitar o seguinte e começar a trabalhar com um bot de reunião de IA.

"Envie um bot para esta reunião: <meeting_url>"
"Peça ao bot para dizer 'Olá'", e o bot diria 'Olá' na reunião.
"Peça ao bot para enviar uma mensagem de chat: 'Que bom estar aqui'", e o bot escreveria 'Que bom estar aqui' no chat.
"Peça ao bot para sair da reunião"

Claude Bot

Combinando MCPs

Combinar MCPs leva a fluxos de trabalho poderosos. Por exemplo, eu uso o MCP de Busca Brave junto com o MCP de Participantes. Quando pergunto ao Claude: "Quem venceu o último torneio de Roland Garros?", ele:

Usa o MCP da web para encontrar a resposta online.
Envia o resultado para o bot de Participantes, que fala a resposta de volta para mim.

🚀 Instalação

Usaremos o Claude como exemplo, mas você pode usar qualquer ferramenta que funcione com MCPs.

Clone o repositório

# Clone your fork or the main repo
git clone https://github.com/rexposadas/attendee-mcp.git
cd attendee-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

# Link for global use
npm link

⚙️ Configuração

Variáveis de Ambiente

Defina estas variáveis de ambiente para o seu servidor de Participantes:

export MEETING_BOT_API_URL="http://localhost:8000"  # Your Attendee server URL
export MEETING_BOT_API_KEY="your-api-key-here"     # Your Attendee API key

Adicione-as ao seu perfil de shell (~/.zshrc, ~/.bashrc, etc.) para torná-las permanentes.

Configuração do Claude Desktop

Atualize o arquivo de configuração do seu Claude Desktop em: ~/Library/Application Support/Claude/claude_desktop_config.json. Após fazer as alterações, reinicie o Claude.

Ajuste a seção `mcpServers` para incluir o servidor MCP de Participantes. Use o caminho direto por enquanto, pois está se mostrando o mais confiável.

{
  "mcpServers": {
    "attendee": {
      "command": "node",
      "args": [
        "<path>/attendee-mcp/dist/index.js"
      ],
      "env": {
        "MEETING_BOT_API_URL": "<attendee-url-here>",
        "MEETING_BOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Substitua /path/to/attendee-mcp pelo caminho real onde você clonou o repositório.

🏃‍♂️ Início Rápido se você quiser executar o Attendee localmente.

Inicie o seu servidor de Participantes:
```
make build
make up
```
Teste no Claude Desktop:
- Pergunte ao Claude: "Quais ferramentas MCP estão disponíveis?"

🎯 Exemplos de Uso

Uma vez configurado, você pode usar comandos em linguagem natural no Claude Desktop:

Criando Bots de Reunião

"Crie um bot de reunião para este Zoom: https://zoom.us/j/123456789"
"Envie um bot para este Google Meet: https://meet.google.com/abc-defg-hij"
"Entre nesta reunião do Teams com um bot: https://teams.microsoft.com/..."

Gerenciando Bots

"Qual é o status do bot bot_abc123?"
"Remova o bot bot_abc123 da reunião"

🔧 Ferramentas MCP Disponíveis

Este servidor fornece as seguintes ferramentas:

Gerenciamento Principal de Bots

create_meeting_bot - Cria um bot para entrar e gravar uma reunião
get_bot_status - Verifica o status atual de um bot de reunião
remove_meeting_bot - Remove um bot de uma reunião

Comunicação e Mídia

make_bot_speak - Faz o bot falar usando texto para fala
send_chat_message - Envia mensagens de chat do bot
send_image_to_meeting - Exibe imagens através do bot (apenas Google Meet)
send_video_to_meeting - Reproduz vídeos através do bot (apenas Google Meet)

Recuperação de Dados

get_meeting_transcript - Recupera a transcrição da reunião
get_chat_messages - Obtém mensagens de chat da reunião
get_recording - Obtém a URL de download da gravação
delete_bot_data - Exclui permanentemente todos os dados do bot

🐛 Solução de Problemas

Problemas Comuns

"Erro de rede" ou problemas de conexão com a API:
- Certifique-se de que o seu servidor de Participantes está rodando na URL configurada
- Verifique se a sua chave de API está correta
- Confirme as variáveis de ambiente MEETING_BOT_API_URL e MEETING_BOT_API_KEY
Servidor MCP não aparecendo no Claude Desktop:
- Reinicie o Claude Desktop completamente após alterações na configuração
- Verifique se a sintaxe do arquivo de configuração do Claude Desktop é JSON válido
- Consulte os logs do Claude Desktop para mensagens de erro
Erros de "Método não permitido":
- Alguns endpoints da API podem não estar totalmente implementados no seu servidor de Participantes
- Verifique os logs do seu servidor de Participantes para mais detalhes

📄 Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

🤝 Contribuindo

Faça um fork do repositório
Crie um branch de funcionalidade: git checkout -b feature-name
Faça suas alterações e teste-as
Faça commit das suas alterações: git commit -m 'Add feature'
Envie para o branch: git push origin feature-name
Envie um pull request

🔗 Projetos Relacionados

Attendee - O principal serviço de bot de reunião
Model Context Protocol - A especificação e o SDK do MCP

Nota: Este servidor MCP requer um serviço de backend do Attendee em execução. Certifique-se de que o servidor do Attendee esteja configurado e rodando antes de usar este servidor MCP.