anime-connect-mcp-bot

Servidor MCP que monitora o chat do app Anime Connect e expõe os dados (mensagens, alertas) como ferramentas para um assistente de IA (Claude) consultar.

Camadas

• src/ingestion — capta mensagens da fonte de chat. FirebaseChatSource lê os grupos com has_bot: true do Realtime Database; MockChatSource fica só para dev/teste.

• src/domain — entidades (ChatMessage, Alert), regras puras (detecção de palavras-chave) e botSettings.ts (personalização por grupo, ver abaixo).

• src/actuation — escreve de volta no chat (FirebaseActuator) ou só loga (DryRunActuator).

• src/agent — comandos do chat (!ping, !help, !ban) e permissões por cargo.

• src/storage — persistência em SQLite (MessageRepository).

• src/mcp — servidor MCP com as tools get_recent_messages, search_messages, get_recent_alerts.

• src/config — variáveis de ambiente (DB_PATH, POLL_INTERVAL_MS, DRY_RUN).

Related MCP server: mcp-server-agent-comm

Personalização por grupo (bot_settings)

O dono de cada grupo edita o bot pelo próprio app Anime Connect (tela de configuração do bot), o que grava em groups/{id}/bot_settings no Realtime Database:

• Identidade: name e avatar_color — o usuário-bot desse grupo é criado/atualizado com esses valores (FirebaseActuator, campo bot_group_id liga o usuário ao grupo).

• Ativação real: active — enquanto false, o bot só loga o que faria nesse grupo, mesmo com DRY_RUN=false no .env (que continua sendo o disjuntor geral do processo).

• Comandos: commands.ping/help/ban.enabled liga/desliga cada um; commands.ping.message é a resposta customizada do !ping.

• Moderação: keyword_alerts e badwords, strings separadas por vírgula, substituem os KEYWORD_ALERTS/BADWORDS globais do .env para aquele grupo.

Grupo sem bot_settings salvo usa os defaults de src/domain/botSettings.ts (DEFAULT_BOT_SETTINGS), com active: false por segurança.

Rodar

npm install
npm run dev     # modo desenvolvimento (tsx watch)
npm run build && npm start   # build + produção

Próximo passo

Substituir MockChatSource por uma implementação real que fale com o app Anime Connect (API REST, webhook ou leitura direta do banco, dependendo de como o chat do app é exposto).