MCP Whaileys

MCP Whaileys Context

Servidor MCP (Model Context Protocol) para fornecer contexto completo da biblioteca Whaileys (WhatsApp) ao assistente de IA.

O repositório whaileys é baixado automaticamente na primeira execução.

Funcionalidades

Este servidor combina análise de AST com knowledge base de domínio para fornecer contexto completo sobre WhatsApp/Baileys:

Análise de AST (ts-morph)

• Interfaces - com propriedades, métodos, call signatures e index signatures
• Type Aliases - com type parameters e definições completas
• Enumerations - com todos os valores
• Functions - com parâmetros, tipos de retorno e documentação
• Classes - com métodos públicos, propriedades e herança
• Variables/Constants - configurações e defaults exportados
• Namespaces - estrutura de namespaces exportados
• Re-exports - análise de re-exportações entre módulos

Domain Knowledge (v2.0)

• 12 knowledge bases curadas com referência completa de tipos, métodos e padrões
• WAProto parser para navegação dinâmica de 80+ tipos protobuf
• 36 code examples prontos para copiar/colar
• Guides para media, groups, calls, chat e connection

Ferramentas Disponíveis (30 tools)

Ferramentas de AST

Ferramentas por Categoria

Ferramentas de Análise

Ferramentas de Domínio

Ferramentas de Referência

Ferramentas WAProto & Examples

Ferramentas de Auto-Update

Categorias Suportadas

interface   - Interfaces TypeScript
type        - Type Aliases
enum        - Enumerations
function    - Funções exportadas
class       - Classes exportadas
variable    - Constantes e variáveis
namespace   - Namespaces
re-export   - Re-exportações

Instalação

Opção 1: Via npx (recomendado)

Sem instalação prévia, use diretamente no VSCode:

{
  "servers": {
    "whaileys-context": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-whaileys"]
    }
  }
}

Opção 2: Instalação global

npm install -g mcp-whaileys

{
  "servers": {
    "whaileys-context": {
      "type": "stdio",
      "command": "mcp-whaileys"
    }
  }
}

Opção 3: Repositório local

git clone https://github.com/SEU_USUARIO/mcp-whaileys.git
cd mcp-whaileys
npm install
npm run build

{
  "servers": {
    "whaileys-context": {
      "type": "stdio",
      "command": "node",
      "args": ["d:/caminho/para/mcp-whaileys/dist/index.js"]
    }
  }
}

Onde fica o repositório Whaileys?

Na primeira execução, o MCP baixa automaticamente o repositório para:

• Windows: C:\Users\SEU_USUARIO\.mcp-whaileys\whaileys
• Linux/Mac: ~/.mcp-whaileys/whaileys

Para usar um caminho personalizado, defina WHAILEYS_PATH:

{
  "servers": {
    "whaileys-context": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-whaileys"],
      "env": {
        "WHAILEYS_PATH": "d:/meu/caminho/whaileys/src"
      }
    }
  }
}

Variáveis de Ambiente

Exemplos de Configuração

Configuração mínima (usa auto-download)

{
  "whaileys-context": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "mcp-whaileys"]
  }
}

Configuração com path local existente

{
  "whaileys-context": {
    "type": "stdio",
    "command": "node",
    "args": ["/caminho/para/mcp-whaileys/dist/index.js"],
    "env": {
      "WHAILEYS_PATH": "/caminho/para/whaileys/src"
    }
  }
}

Configuração completa

{
  "whaileys-context": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "mcp-whaileys"],
    "env": {
      "AUTO_UPDATE_ENABLED": "true",
        "AUTO_UPDATE_INTERVAL": "3600000"
      }
    }
  }
}

Exemplos de Uso

Extrair todos os tipos do módulo Types

whaileys_extrair_tipos({ modulo: "Types" })

Filtrar apenas interfaces do módulo Types

whaileys_extrair_tipos({ modulo: "Types", apenas_kind: "interface" })

Buscar tipo específico

whaileys_buscar_tipo({ nome: "WAMessage" })

Busca fuzzy quando não sabe o nome exato

whaileys_buscar_fuzzy({ query: "message send auth" })

Busca contextual por domínio

whaileys_buscar_contexto({ query: "auth state", modulo: "Utils", limite: 10 })

Resumo orientado de módulo

whaileys_resumo_modulo({ modulo: "Socket", destaque: 15 })

Descoberta por tópicos

whaileys_topicos({ topico: "media" })

Consultar tipos de mensagem

whaileys_messages()
whaileys_messages({ type: "buttons" })
whaileys_messages({ category: "interactive" })

Consultar mensagens interativas

whaileys_interactive({ type: "carousel" })

Referência de eventos

whaileys_events()
whaileys_events({ event: "messages.upsert" })
whaileys_events({ category: "messaging" })

Referência JID/LID

whaileys_jid()
whaileys_jid({ topic: "lid" })

Métodos do WASocket

whaileys_socket_methods()
whaileys_socket_methods({ category: "groups" })
whaileys_socket_methods({ method: "sendMessage" })

Guias de referência

whaileys_guides({ topic: "media" })
whaileys_guides({ topic: "groups" })
whaileys_connection({ topic: "config" })
whaileys_chat({ topic: "modifications" })

Navegar WAProto

whaileys_proto()
whaileys_proto({ category: "interactive" })
whaileys_proto({ search: "poll" })
whaileys_proto_type({ name: "ButtonsMessage" })
whaileys_proto_type({ name: "InteractiveMessage" })

Code examples prontos

whaileys_examples()
whaileys_examples({ id: "send-carousel" })
whaileys_examples({ search: "poll" })
whaileys_examples({ tag: "connection" })

Ver todas as funções do módulo Utils

whaileys_funcoes({ modulo: "Utils" })

Listar constantes de configuração

whaileys_constantes({ modulo: "Defaults" })

Ver hierarquia de um tipo

whaileys_hierarquia({ nome: "BaileysEventEmitter" })

Estatísticas completas da biblioteca

whaileys_estatisticas()

Análise de dependências

whaileys_dependencias()

Estrutura de Dados

ExtractedType

interface ExtractedType {
  name: string              // Nome da declaração
  kind: ExtractedKind       // Tipo (interface, type, enum, etc.)
  exported: boolean         // Se é exportado
  file: string              // Arquivo fonte
  module: string            // Módulo (Types, Socket, Utils, etc.)
  signature: string         // Assinatura TypeScript
  fullSignature?: string    // Assinatura completa (para types)
  properties?: PropertyInfo[] // Propriedades (interfaces/classes)
  methods?: PropertyInfo[]  // Métodos (interfaces/classes)
  members?: string[]        // Membros (enums/namespaces)
  typeParameters?: TypeParameter[] // Generics
  extends?: string[]        // Herança
  implements?: string[]     // Implementações
  docs?: string             // Documentação JSDoc
  value?: string            // Valor (variáveis)
  lineNumber?: number       // Linha no arquivo
}

PropertyInfo

interface PropertyInfo {
  name: string
  type: string
  optional: boolean
  readonly: boolean
  docs?: string
  isMethod: boolean
  isCallSignature: boolean
  isIndexSignature: boolean
  parameters?: string[]
  returnType?: string
}

Estatísticas da Biblioteca

O servidor pode gerar estatísticas detalhadas incluindo:

• Total de declarações por categoria
• Contagem por módulo (Types, Socket, Utils, etc.)
• Top interfaces, types e funções
• Percentuais de distribuição

Recursos Disponíveis

O servidor também expõe recursos via MCP Resources:

Tecnologias

• @modelcontextprotocol/sdk v1.26.0 - SDK oficial do MCP
• ts-morph v27.0.2 - Parser de AST para TypeScript
• zod v4.1.13 - Validação de schemas

Sistema de Auto-Update

O MCP Whaileys possui um sistema integrado de auto-atualização que monitora o repositório oficial canove/whaileys no GitHub.

Como funciona

1. Na inicialização: O servidor verifica se há atualizações disponíveis
2. Periodicamente: A cada intervalo configurado (default: 1 hora), verifica novos commits
3. Automaticamente: Quando detecta uma atualização, executa git pull automaticamente
4. Cache de SHA: Mantém um registro do último commit verificado para otimizar chamadas à API

Fluxo de atualização

flowchart TD
    A[GitHub API
/repos/canove/whaileys/commits] --> B[Compara SHA
Local vs Remoto]
    B --> C{SHA diferente?}
    C -->|Sim| D[git pull]
    C -->|Não| E[OK - Sem alterações]
    D --> F[Atualiza contexto]
    F --> G[Salva novo SHA no cache]

Comandos manuais

// Verificar se há atualizações (sem aplicar)
whaileys_check_updates()

// Aplicar atualizações disponíveis
whaileys_update()

// Ver status atual do repositório
whaileys_status()

Logs

O servidor emite logs durante o processo de atualização:

[INFO] Auto-update habilitado (intervalo: 60 min)
[INFO] Verificando atualizações...
[OK] Atualizado para: ea7f714
      Commit: Merge pull request #56 from canove/develop

Rate Limiting do GitHub

A API do GitHub possui limites de requisições:

• Sem token: 60 requests/hora
• Com token: 5000 requests/hora

Para ambientes de produção, configure GITHUB_TOKEN para evitar rate limiting.