Servidor Telegram MCP

¿Qué hace el Servidor “Telegram” MCP?

El Servidor Telegram MCP integra las potentes capacidades de la plataforma de mensajería Telegram con el Model Context Protocol (MCP), permitiendo que los asistentes de IA y clientes interactúen programáticamente con Telegram. Al utilizar la biblioteca Telethon, este servidor permite la automatización integral y la gestión de chats, mensajes, grupos e interacciones de usuarios dentro de Telegram. Actúa como un puente entre los agentes de IA y la API de Telegram, haciendo posible realizar tareas como enviar mensajes, recuperar historiales de chat, gestionar grupos y más. Esto mejora drásticamente los flujos de trabajo de desarrollo al agilizar la comunicación, facilitar respuestas automáticas y proporcionar herramientas para consultar o modificar datos de Telegram directamente desde herramientas potenciadas por IA como Claude, Cursor y otros clientes compatibles con MCP.

Lista de Prompts

No se listaron plantillas de prompt en la documentación disponible ni en los archivos del repositorio.

Lista de Recursos

No se documentaron ni listaron primitivas de recursos MCP explícitos en los archivos disponibles o en el README.

Lista de Herramientas

• get_chats(page, page_size): Devuelve una lista paginada de chats y grupos de Telegram disponibles para el usuario autenticado. Esto permite que los clientes y LLMs enumeren y seleccionen del historial de conversaciones del usuario para análisis o mensajería posterior.

La documentación indica que “todas las funciones principales de Telegram/Telethon están disponibles como herramientas”, pero solo se menciona explícitamente get_chats. La lista completa de herramientas no se proporciona en la documentación visible.

Casos de Uso de este Servidor MCP

• Mensajería Automatizada: Los agentes de IA pueden enviar mensajes, medios o archivos a personas o grupos en Telegram, permitiendo notificaciones automatizadas, respuestas o difusiones.
• Análisis de Chats: Recupera y analiza historiales de chat para resumir discusiones, extraer tareas o realizar análisis de sentimiento en grupos o conversaciones privadas de Telegram.
• Gestión de Grupos: Gestiona programáticamente la membresía de grupos, roles y permisos para una administración eficiente de comunidades o equipos.
• Integración de Bots: Usa el servidor para operar bots de Telegram que realicen flujos de trabajo complejos, transmitan información o actúen como asistentes virtuales potenciados por IA.
• Extracción de Datos Sin Interrupciones: Extrae mensajes, archivos o detalles de chats específicos para integrarlos con sistemas externos, paneles o bases de datos, apoyando la automatización avanzada.

Cómo configurarlo

Windsurf

1. Requisito previo: Asegúrate de que Node.js esté instalado y Windsurf esté configurado.
2. Localiza la Configuración: Abre tu archivo de configuración o ajustes de Windsurf.
3. Agrega el Servidor MCP: Inserta el servidor Telegram MCP en la sección mcpServers:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Guarda y Reinicia: Guarda tu configuración y reinicia Windsurf.
5. Verifica la Configuración: Revisa el panel de Windsurf o los registros para comprobar que telegram-mcp está en ejecución.

Protegiendo las claves API (ejemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. Requisito previo: Asegúrate de que Claude Desktop o un cliente compatible con Claude esté instalado.
2. Localiza la Configuración: Edita el archivo claude_desktop_config.json.
3. Agrega el Servidor MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Guarda y Reinicia: Guarda el archivo JSON y reinicia Claude.
5. Verifica: Confirma que Claude detecte y se conecte a telegram-mcp.

Protegiendo las claves API (ejemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. Requisito previo: Instala Node.js y el editor Cursor.
2. Abre los Ajustes de Cursor: Accede a la sección de integración MCP.
3. Agrega el Servidor Telegram MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Reinicia Cursor: Guarda los ajustes y reinicia la aplicación Cursor.
5. Verifica: Confirma que Cursor reconozca y se conecte al servidor Telegram MCP.

Protegiendo las claves API (ejemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. Requisito previo: Asegúrate de que Cline esté instalado y configurado.
2. Abre el Archivo de Configuración: Edita tu archivo de configuración o ajustes de Cline.
3. Inserta el Servidor MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Guarda y Reinicia: Guarda el archivo y reinicia Cline.
5. Verifica: Revisa la interfaz de Cline para confirmar que el servidor Telegram MCP está en ejecución.

Protegiendo las claves API (ejemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cómo usar este MCP dentro de los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza agregando el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración MCP del sistema, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “telegram-mcp” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Descripción General

Soporte para Roots: No se menciona explícitamente
Soporte de muestreo: No se menciona explícitamente

Calificaría el Servidor Telegram MCP con un 6/10. Es funcionalmente robusto y proporciona instrucciones claras de configuración y seguridad, pero carece de documentación sobre plantillas de prompt, recursos explícitos y una lista exhaustiva de herramientas, aspectos importantes para la integración MCP avanzada y la transparencia.

Puntaje MCP