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?
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:
npx -y @chaindead/telegram-mcp auth ...
{
"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
- Descargue la última versión para su arquitectura:
- Extraiga el archivo
.zip - 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.
- Obtenga el ID de API y el hash de la API de Telegram
- 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>
- ¡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.
- 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
- Agregar la configuración del servidorPara 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"
}
}
}
}
{
"mcpServers": {
"telegram-mcp": {
"command": "telegram-mcp",
"env": {
"TG_APP_ID": "<your-app-id>",
"TG_API_HASH": "<your-api-hash>"
}
}
}
}
Historia de las estrellas