MCP WhatsMeow Context

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

O repositório tulir/whatsmeow é baixado automaticamente na primeira execução.

Funcionalidades

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

Análise de AST (Go Parser)

• Interfaces - com campos e métodos
• Structs - com campos tipados e tags
• Types - type aliases e definições
• Functions - com parâmetros e retornos
• Methods - receivers e assinaturas
• Constants - iota, strings, erros comuns
• Variables - exportadas e configurações

Domain Knowledge (v2.0)

• 16 knowledge bases curadas com referência completa de tipos, métodos e padrões
• waE2E Proto browser para navegação dinâmica de 13.000+ tipos protobuf
• 40 code examples de produção extraídos de API_WHATSMEOW
• Guides para media, groups, calls, chat e connection

Ferramentas Disponíveis (38 tools)

Ferramentas de AST

Ferramentas de Conteúdo

Ferramentas de Repositório

Ferramentas de Domínio

Ferramentas de Referência

Ferramentas de Knowledge

Ferramentas waE2E Proto

Ferramentas de Examples

Categorias Suportadas

interface   - Interfaces Go
struct      - Structs Go
type        - Type aliases
function    - Funções exportadas
method      - Métodos com receivers
const       - Constantes (iota, valores)
variable    - Variáveis exportadas

Instalação

Opção 1: Via npx (recomendado)

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

Opção 2: Instalação global

npm install -g mcp-whatsmeow

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

Opção 3: Repositório local

git clone https://github.com/jobasfernandes/mcp-whatsmeow.git
cd mcp-whatsmeow
npm install
npm run build

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

Variáveis de Ambiente

Exemplos de Uso

Extrair tipos de um módulo

whatsmeow_extrair_tipos({ modulo: "types" })
whatsmeow_extrair_tipos({ modulo: "proto", apenas_kind: "struct" })

Buscar tipo específico

whatsmeow_buscar_tipo({ nome: "Client" })
whatsmeow_buscar_tipo({ nome: "SendMessageParams" })

Busca fuzzy e semântica

whatsmeow_buscar_fuzzy({ query: "send message" })
whatsmeow_buscar_contexto({ query: "qr pairing", limite: 10 })

Resumo e tópicos

whatsmeow_resumo_modulo({ modulo: "root", destaque: 15 })
whatsmeow_topicos({ topico: "newsletter" })

Consultar tipos de mensagem

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

Mensagens interativas

whatsmeow_interactive()
whatsmeow_interactive({ type: "buttons" })
whatsmeow_interactive({ type: "list" })

Sistema de eventos

whatsmeow_events()
whatsmeow_events({ category: "appstate" })
whatsmeow_events({ event: "Message" })

Referência JID/LID

whatsmeow_jid()
whatsmeow_jid({ topic: "lid" })
whatsmeow_jid({ topic: "utilities" })

Métodos do Client

whatsmeow_client_methods()
whatsmeow_client_methods({ category: "messaging" })
whatsmeow_client_methods({ method: "SendMessage" })

Guias de referência

whatsmeow_guides({ topic: "media" })
whatsmeow_guides({ topic: "groups" })
whatsmeow_connection({ topic: "qr" })
whatsmeow_chat({ topic: "presence" })

Knowledge especializado

whatsmeow_newsletter()
whatsmeow_privacy({ topic: "blocklist" })
whatsmeow_appstate({ topic: "builders" })
whatsmeow_media({ topic: "encryption" })
whatsmeow_groups({ topic: "community" })
whatsmeow_store({ topic: "interfaces" })
whatsmeow_history({ topic: "download" })

Navegar waE2E Proto

whatsmeow_proto()
whatsmeow_proto({ category: "message" })
whatsmeow_proto({ search: "poll" })
whatsmeow_proto_type({ name: "InteractiveMessage" })
whatsmeow_proto_type({ name: "ImageMessage" })

Code examples de produção

whatsmeow_examples()
whatsmeow_examples({ category: "senders" })
whatsmeow_examples({ id: "send-buttons" })
whatsmeow_examples({ search: "sticker" })

Estatísticas e análise

whatsmeow_estatisticas()
whatsmeow_dependencias()
whatsmeow_hierarquia({ nome: "Client" })

Recursos MCP

Tecnologias

• @modelcontextprotocol/sdk v1.26.0 - SDK oficial do MCP
• Go AST Parser - Parser regex-based para código Go
• zod v4.1.13 - Validação de schemas

Desenvolvimento Local

npm install
npm run build
npm start