Servidor MCP de ClickSend

Name: ClickSend MCP Server
Author: J-Gal02

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona mensajería SMS y funciones de llamada de texto a voz (TTS) a través de la API de ClickSend. Este servidor permite a los modelos de IA enviar SMS e iniciar llamadas de voz mediante programación.

Características

Mensajería SMS : envía mensajes SMS a cualquier número de teléfono en todo el mundo
Llamadas de texto a voz : realice llamadas de voz con mensajes de texto a voz personalizables
Limitación de velocidad : protección integrada con límite de 5 acciones por minuto
Validación de entrada : validación integral de números de teléfono y contenido de mensajes
Manejo de errores : mensajes de error detallados y propagación adecuada de errores

Related MCP server: Slack MCP Server

Instalación

Prerrequisitos

Node.js (v16 o superior)
Cuenta de ClickSend con credenciales de API
Cliente compatible con MCP

Configuración

Clonar el repositorio:

git clone https://github.com/J-Gal02/clicksend-mcp.git cd clicksend-mcp

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Configuración del cliente MCP

Agregue las siguientes secciones en su archivo cline_mcp_settings.json o claude_desktop_config.json .

Asegúrese de reemplazar el directorio con la ruta correcta a la carpeta de compilación, como se muestra en el siguiente ejemplo, así como el nombre de usuario y la clave API con los suyos.

{ "mcpServers": { "clicksend": { "command": "node", "args": ["/directory/to/build/folder/clicksend-mcp/build/index.js"], "env": { "CLICKSEND_USERNAME": "example@droove.net", "CLICKSEND_API_KEY": "ZZZZZZZZ-YYYY-YYYY-YYYY-XXXXXXXXXXXX" } } } }

Uso

Herramientas disponibles

1. enviar_sms

Envía mensajes SMS a números de teléfono especificados.

Parámetros:

to : Número de teléfono en formato E.164 (por ejemplo, +61423456789)
message : Contenido del texto a enviar

Ejemplo:

{ "name": "send_sms", "arguments": { "to": "+61423456789", "message": "Hello from ClickSend MCP!" } }

2. hacer_llamada_tts

Iniciar llamadas de texto a voz.

Parámetros:

to : Número de teléfono en formato E.164
message : Contenido de texto para convertir a voz
voice : tipo de voz ('femenino' o 'masculino', predeterminado 'femenino')

Ejemplo:

{ "name": "make_tts_call", "arguments": { "to": "+61423456789", "message": "This is a Text-to-Speech call from ClickSend MCP", "voice": "female" } }

Limitación de velocidad

El servidor implementa un límite de 5 acciones por minuto para evitar abusos. Las solicitudes que superen este límite recibirán una respuesta de error con una sugerencia de retraso de reintento.

Desarrollo

Scripts disponibles

npm run build : compila TypeScript y hace que la salida sea ejecutable
npm run start : Inicia el servidor MCP
npm run dev : ejecuta el compilador de TypeScript en modo de observación

Estructura del proyecto

clicksend-mcp/ ├── src/ │ ├── index.ts # Main server implementation │ ├── client.ts # ClickSend API client │ └── utils/ │ └── validation.ts # Input validation utilities ├── build/ # Compiled JavaScript output └── package.json # Project configuration

Manejo de errores

El servidor proporciona mensajes de error detallados para varios escenarios:

Números de teléfono no válidos
Errores de validación del contenido del mensaje
Límite de velocidad excedido
Errores de autenticación de API
Problemas de conectividad de red

Las respuestas de error incluyen códigos de error apropiados y mensajes descriptivos para ayudar a diagnosticar problemas.

HACER

[ ] Múltiples destinatarios
[ ] Configurar los ID del remitente
[x] SMS
[x] TTS
[ ] Correo electrónico
[ ] Carga de medios
- [ ] Archivos adjuntos de correo electrónico
- [ ] MMS
- [ ] Cartas
- [ ] Postales
- [ ] Fax
[ ] Cálculo y confirmación de costos
[ ] Estadísticas
[ ] Historia
[ ] Contactos
[ ] Automatizaciones