Servidor MCP de Telegram

El servidor es un puente entre la API de Telegram y los asistentes de IA y se basa en el Protocolo de Contexto de Modelo .

[!IMPORTANTE] Asegúrate de leer y comprender los Términos de Servicio de la API de Telegram antes de usar este servidor. Cualquier uso indebido de la API de Telegram puede resultar en la suspensión de tu cuenta.

Tabla de contenido

• ¿Qué es MCP?

• ¿Qué hace este servidor?

  • Capacidades

  • Ejemplos de indicaciones

    • Gestión de mensajes

    • Organización

    • Comunicación

• Instalación

  • Cerveza casera

  • NPX

  • De lanzamientos

    • Sistema operativo Mac

    • Linux

    • Ventanas

  • De la fuente

• Configuración

  • Autorización

  • Configuración del cliente

• Historia de las estrellas

Related MCP server: q0t-telegram-mcp

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un sistema que permite que las aplicaciones de IA, como Claude Desktop o Cursor, se conecten a herramientas y fuentes de datos externas. Ofrece una forma clara y segura para que los asistentes de IA trabajen con servicios y API locales, manteniendo al usuario en control.

¿Qué hace este servidor?

Capacidades

• [x] Obtener información de la cuenta actual ( tool: tg_me )

• [x] Lista de diálogos con filtro opcional de no leídos ( tool: tg_dialogs )

• [x] Marcar el diálogo como leído ( tool: tg_read )

• [x] Recuperar mensajes de un diálogo específico ( tool: tg_dialog )

• [x] Enviar borradores de mensajes a cualquier diálogo ( tool: tg_send )

Ejemplos de indicaciones

A continuación se muestran algunos ejemplos de indicaciones que puedes utilizar con asistentes de IA:

Gestión de mensajes

• "Comprueba si hay mensajes importantes sin leer en mi Telegram"

• "Resumir todos mis mensajes de Telegram no leídos"

• Leer y analizar mis mensajes no leídos y preparar borradores de respuesta cuando sea necesario.

• Revisa los mensajes no leídos que no sean críticos y dame una breve descripción general.

Organización

• Analizar mis diálogos de Telegram y sugerir una estructura de carpetas.

• Ayúdame a clasificar mis chats de Telegram por importancia.

• Encuentra todas las conversaciones relacionadas con el trabajo y sugiere cómo organizarlas.

Comunicación

• Monitorizar el chat específico para obtener actualizaciones sobre [tema]

• Redacta una respuesta cortés al último mensaje en [chat]

• "Comprueba si hay preguntas sin respuesta en mis chats"

Instalación

Cerveza casera

Puedes instalar una versión binaria en macOS/Linux usando brew:

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

Puede ejecutar la última versión directamente usando npx (compatible con macOS, Linux y Windows):

npx -y @chaindead/telegram-mcp

Al utilizar NPX, modifique los comandos y la configuración estándar de la siguiente manera:

• El comando de autenticación se convierte en:

npx -y @chaindead/telegram-mcp auth ...

• La configuración del servidor Claude MCP se convierte en:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Para obtener instrucciones de configuración completas, consulte Autorización y configuración del cliente .

De lanzamientos

Sistema operativo Mac

Nota: Los siguientes comandos se instalan en /usr/local/bin . Para instalar en otro lugar, reemplace /usr/local/bin con el directorio que prefiera en su PATH.

Primero, descargue el archivo para su arquitectura:

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

Luego instala el binario:

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

Nota: Los siguientes comandos se instalan en /usr/local/bin . Para instalar en otro lugar, reemplace /usr/local/bin con el directorio que prefiera en su PATH.

Primero, descargue el archivo para su arquitectura:

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

Luego instala el binario:

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Ventanas

Ventanas

1. Descargue la última versión para su arquitectura:

   • Ventanas x64

   • Windows ARM64

2. Extraiga el archivo .zip

3. Agregue el directorio extraído a su RUTA o mueva telegram-mcp.exe a un directorio en su RUTA

De la fuente

Requisitos:

• Vaya a 1.24 o posterior

• GOBIN en PATH

go install github.com/chaindead/telegram-mcp@latest

Configuración

Autorización

Antes de poder utilizar el servidor, debe conectarse a la API de Telegram.

1. Obtenga el ID de API y el hash de la API de Telegram

2. Ejecute el siguiente comando:

   Nota: Si tiene 2FA habilitado: agregue --password <2fa_password>

   Nota: Si desea anular la sesión existente: agregue --new

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>

   📩 Ingresa el código que recibiste de Telegram para conectarte a la API.

3. ¡Listo! Dale un ⭐️ a este proyecto para apoyar su desarrollo.

Configuración del cliente

Ejemplo de configuración de Claude Desktop para reconocer el servidor MCP de Telegram.

1. Abra el archivo de configuración de Claude Desktop:

   • En MacOS, el archivo de configuración se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json

   • En Windows, el archivo de configuración se encuentra en %APPDATA%\Claude\claude_desktop_config.json

   Nota: También puedes encontrar claude_desktop_config.json dentro de la configuración de la aplicación Claude Desktop

2. Agregar la configuración del servidor

   Para el escritorio de Claude:

    {
      "mcpServers": {
        "telegram": {
          "command": "telegram-mcp",
          "env": {
            "TG_APP_ID": "<your-app-id>",
            "TG_API_HASH": "<your-api-hash>",
            "PATH": "<path_to_telegram-mcp_binary_dir>",
            "HOME": "<path_to_your_home_directory"
          }
        }
      }
    }

   para Cursor:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "env": {
           "TG_APP_ID": "<your-app-id>",
           "TG_API_HASH": "<your-api-hash>"
         }
       }
     }
   }

Historia de las estrellas