smileapi-mcp

smileapi-mcp

0
communication

This project is an MCP server for integrating with the SmileAPI, enabling the transmission of diverse message types such as texts, images, and videos by leveraging language models. It is designed to be versatile and easy to use for seamless communication.

Servidor MCP para SmileAPI

smithery badge

Este é um servidor MCP (Model Context Protocol) para integração com a SmileAPI, permitindo o envio de mensagens de texto, imagens, vídeos, áudios e documentos através de ferramentas disponibilizadas para modelos de linguagem.

Requisitos

  • Node.js 14+ instalado
  • Conta na SmileAPI com credenciais de acesso

Instalação

Installing via Smithery

To install smileapi-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @edupoli/smileapi-mcp --client claude

Installing Manually

  1. Clone este repositório
  2. Instale as dependências:
npm install
  1. Configure as variáveis de ambiente:
cp .env.example .env
  1. Edite o arquivo .env com suas credenciais da SmileAPI:
SMILE_API_USERNAME=seuusername
SMILE_API_PHONE_NUMBER_ID=seuphoneID
SMILE_API_TOKEN=seutoken

Uso

Como servidor MCP

Para iniciar o servidor MCP:

npm start

Chamada direta de ferramentas

Você também pode executar as ferramentas diretamente via linha de comando:

# Enviar texto
node index.js envia_texto '{"to":"5543996611437","text":"Olá, esta é uma mensagem de teste!"}'

# Enviar imagem
node index.js envia_imagem '{"to":"5543996611437","link":"https://exemplo.com/imagem.jpg","caption":"Imagem de teste"}'

# Enviar vídeo
node index.js envia_video '{"to":"5543996611437","link":"https://exemplo.com/video.mp4","caption":"Vídeo de teste"}'

# Enviar áudio
node index.js envia_audio '{"to":"5543996611437","link":"https://exemplo.com/audio.mp3"}'

# Enviar documento
node index.js envia_documento '{"to":"5543996611437","link":"https://exemplo.com/documento.pdf","caption":"Documento de teste","fileName":"documento.pdf"}'

Ferramentas disponíveis

envia_texto

Envia mensagem de texto.

Parâmetros:

  • to: Número do destinatário (ex: 5543996611437)
  • delayMessage: Atraso para enviar a mensagem em segundos (opcional, padrão: 0)
  • delayTyping: Atraso para simular digitação em segundos (opcional, padrão: 0)
  • text: Texto da mensagem

envia_imagem

Envia uma imagem.

Parâmetros:

  • to: Número do destinatário
  • delayMessage: Atraso para enviar em segundos (opcional, padrão: 0)
  • link: URL da imagem
  • caption: Legenda da imagem (opcional)
  • viewOnce: Define se a imagem será visualizada apenas uma vez (opcional, padrão: false)

envia_video

Envia um vídeo.

Parâmetros:

  • to: Número do destinatário
  • delayMessage: Atraso para enviar em segundos (opcional, padrão: 0)
  • link: URL do vídeo
  • caption: Legenda do vídeo (opcional)
  • viewOnce: Define se o vídeo será visualizado apenas uma vez (opcional, padrão: false)

envia_audio

Envia um áudio.

Parâmetros:

  • to: Número do destinatário
  • delayMessage: Atraso para enviar em segundos (opcional, padrão: 0)
  • link: URL do áudio

envia_documento

Envia um documento.

Parâmetros:

  • to: Número do destinatário
  • delayMessage: Atraso para enviar em segundos (opcional, padrão: 0)
  • link: URL do documento
  • caption: Legenda do documento (opcional)
  • fileName: Nome do arquivo do documento (opcional)

Integração com modelos de linguagem

Este servidor foi projetado para ser utilizado com modelos de linguagem que suportam o protocolo MCP, permitindo que eles enviem mensagens através da SmileAPI.