Comunicador MCP (Telegram)

Un servidor MCP que permite la comunicación con los usuarios a través de Telegram. Este servidor proporciona herramientas para interactuar con los usuarios mediante un bot de Telegram, incluyendo la posibilidad de hacer preguntas, enviar notificaciones, compartir archivos y crear archivos de proyectos.

Instalación

A través de npm (global)

A través de npx (bajo demanda)

Para obtener tu ID de chat de Telegram:

Related MCP server: Telegram MCP Server

Características

• Haz preguntas a los usuarios a través de Telegram

• Enviar notificaciones a los usuarios (no se requiere respuesta)

• Enviar archivos a los usuarios a través de Telegram

• Crear y enviar archivos zip del proyecto (respetando .gitignore)

• Recibir respuestas de forma asincrónica (espera indefinidamente la respuesta)

• Soporte para seguimiento de mensajes basado en respuestas

• Validación segura de ID de chat

• Manejo y registro de errores

Prerrequisitos

• Node.js (v14 o superior)

• Un token de bot de Telegram (obtenido de @BotFather )

• Tu ID de chat de Telegram (se puede obtener usando la utilidad incluida)

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Crea un bot de Telegram:

   • Abre Telegram y busca @BotFather

   • Envía /newbot y sigue las instrucciones

   • Guarda el token del bot que recibes

4. Obtenga su ID de chat:

   • Copiar .env.example a .env

   • Añade tu token de bot al archivo .env :

     TELEGRAM_TOKEN=your_bot_token_here

   • Ejecute la utilidad de identificación de chat:

     npm run build node build/get-chat-id.js

   • Envía cualquier mensaje a tu bot

   • Copia el ID del chat que aparece en la consola

   • Añade el ID del chat a tu archivo .env :

     TELEGRAM_TOKEN=your_bot_token_here CHAT_ID=your_chat_id_here

Configuración

Agregue el servidor a su archivo de configuración de MCP (generalmente ubicado en %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json en Windows):

Herramientas disponibles

preguntar_usuario

Hace una pregunta al usuario a través de Telegram y espera su respuesta.

Esquema de entrada:

Ejemplo de uso:

notificar_usuario

Envía un mensaje de notificación al usuario a través de Telegram (no se requiere respuesta).

Esquema de entrada:

Ejemplo de uso:

enviar_archivo

Envía un archivo al usuario a través de Telegram.

Esquema de entrada:

Ejemplo de uso:

proyecto zip

Crea un archivo zip de un directorio de proyecto (respetando los patrones .gitignore) y lo envía al usuario a través de Telegram.

Esquema de entrada:

Ejemplo de uso con el directorio predeterminado (directorio de trabajo actual):

Ejemplo de uso con directorio específico:

Características:

• Crea un archivo zip llamado [project-name]-project.zip basado en el nombre del directorio

• Puede comprimir cualquier directorio especificado o el directorio de trabajo actual

• Respeta los patrones .gitignore

• Mantiene las rutas de archivo correctas en el archivo

• Limpia automáticamente el archivo zip después de enviarlo

• Maneja archivos de hasta 2 GB de tamaño

Desarrollo

Construir el proyecto:

Ejecutar en modo de desarrollo:

Esté atento a los cambios:

Directorio de compilación limpio:

Seguridad

• El servidor solo responde a los mensajes del ID de chat configurado

• Las variables de entorno se utilizan para la configuración sensible.

• Los identificadores de mensajes se utilizan para realizar un seguimiento de pares de preguntas y respuestas.

• El bot ignora los mensajes sin el contexto adecuado

Licencia

ISC

Autor

qpd-v

Versión

0.2.1 # Actualización de la versión principal para nuevas funciones: herramientas notify_user, send_file y zip_project