mcpserver.so LogoMCPFly
Submit
WAHA MCP Server logo

WAHA MCP Server

by verissimomanoel

CommunicationWhatsAppAPIFastMCPPython

WAHA MCP Server interacts with a WAHA instance to send WhatsApp messages and read a contact list from a local file. It uses FastMCP framework to expose tools and resources.

View on GitHub

Last updated: N/A

WAHA MCP Server

Linguagem

Linguagem

Servidor MCP (Message Control Protocol) que interage com uma instância do WAHA (WhatsApp HTTP API) para enviar mensagens do WhatsApp e ler uma lista de contatos de um arquivo local.

Funcionalidades Principais ✨

  • Envio de Mensagens via WAHA: Expõe uma ferramenta (send_message) que permite enviar mensagens de texto para números de WhatsApp através de uma API WAHA local.
  • Leitura de Contatos: Expõe um recurso (read_resource) que lê um arquivo JSON local (data/contacts.json) para fornecer uma lista de contatos.
  • Integração com FastMCP: Construído sobre o framework FastMCP para expor ferramentas e recursos.

Tecnologias Utilizadas 🛠️

  • Linguagem: Python 3
  • Framework MCP: FastMCP (do pacote mcp-server)
  • Comunicação HTTP: Biblioteca requests (para interagir com a API WAHA)
  • Dependência Externa: WAHA (WhatsApp HTTP API) - Não incluído neste projeto, deve estar rodando separadamente.

Pré-requisitos 📋

Antes de começar, você precisará ter instalado em sua máquina:

  • Python (recomendado 3.7+)
  • pip (gerenciador de pacotes Python)
  • Uma instância do WAHA (WhatsApp HTTP API) rodando e acessível em http://localhost:3000.
    • Consulte a documentação do WAHA para instalação e configuração.
    • Certifique-se de que uma sessão do WhatsApp (nomeada default neste código) esteja ativa e conectada no WAHA.
  • Git (para clonar o repositório, se aplicável)