45telega - Servidor MCP Telegram Production-Ready
sergekostenchuk/45telega
MCP server Telegram com 45+ métodos, Docker e escalabilidade assíncrona
Ver no GitHubServidor MCP para Telegram com 45+ métodos nativos, suporte completo a autenticação QR, deployment Docker e arquitetura assíncrona escalável. Inclui cache Redis, health checks, logging e configuração baseada em variáveis de ambiente com segurança enterprise.
Instalação
npx convez-ai sergekostenchuk/45telega1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar Telegram como ferramenta de automação em agentes Claude
- Construir bots e automações que gerenciam mensagens, chats e mídia
- Monitorar e processar eventos de Telegram em tempo real via MCP
- Sincronizar dados entre Telegram e outros sistemas via APIs
Veredito

Excelente servidor MCP para integração profissional com Telegram, com toda infraestrutura necessária (Docker, autenticação segura, escalabilidade). Recomendado para quem precisa automatizar fluxos Telegram em agentes Claude com confiabilidade enterprise.
README
A tradução para o português deste README ainda está na fila.
🚀 45telega - Production-Ready Telegram MCP Server
A powerful Model Context Protocol (MCP) server for Telegram with 45+ methods, production-ready deployment, and enterprise features.
✨ Features
- 45+ Telegram Methods: Complete API coverage for messages, chats, users, media
- Production Ready: Docker support, health checks, monitoring, logging
- Secure: Non-root container, environment-based config, session encryption
- Scalable: Async architecture, Redis caching, connection pooling
- Easy Install: One-line installation, auto-updates, multiple deployment options
🚀 Quick Start
Platform-Specific Setup
🪟 Windows + WSL + Kiro IDE
📖 Complete Windows Setup Guide →
Comprehensive step-by-step guide for Windows users with WSL and Kiro IDE integration.
🐧 Linux/macOS
One-Line Install
curl -sSL https://raw.githubusercontent.com/sergekostenchuk/45telega/main/install.sh | bash
PyPI Install
pip install 45telega
Docker Install
docker run -d \
--name 45telega \
-p 8765:8765 \
-e TELEGRAM_API_ID=your_api_id \
-e TELEGRAM_API_HASH=your_api_hash \
-v $(pwd)/data:/data \
ghcr.io/sergekostenchuk/45telega:latest
📋 Prerequisites
- Python 3.9+ or Docker
- Telegram API credentials from my.telegram.org
- 512MB RAM minimum
- Linux/macOS/Windows (with WSL)
🔧 Configuration
1. Get Telegram API Credentials
- Go to my.telegram.org
- Login with your phone number
- Create new application
- Copy
api_idandapi_hash
2. Configure Environment
Copy .env.example to .env:
cp ~/.config/45telega/.env.example ~/.config/45telega/.env
Edit with your credentials:
TELEGRAM_API_ID=your_api_id_here
TELEGRAM_API_HASH=your_api_hash_here
TELEGRAM_PHONE=+1234567890 # Optional
3. First Authentication
45telega sign-in --phone +1234567890
Enter the code you receive on Telegram.
🎯 Usage
Start MCP Server
# Native
45telega run
# Docker
docker-compose up -d
# With custom port
45telega run --port 9000
Add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"45telega": {
"type": "stdio",
"command": "/Users/you/.local/bin/45telega",
"args": ["run"],
"env": {
"TELEGRAM_API_ID": "your_api_id",
"TELEGRAM_API_HASH": "your_api_hash"
}
}
}
}
Add to Kiro IDE (Windows + WSL)
See the Windows Setup Guide for detailed Kiro IDE integration instructions.
📚 Available Methods
Messages
SendMessage- Send text messagesEditMessage- Edit existing messagesDeleteMessage- Delete messagesForwardMessage- Forward messagesReplyToMessage- Reply to specific messagesSendFile- Send files/media
Chats
GetChats- List all chatsGetChatInfo- Get chat detailsGetChatMembers- List chat membersCreateGroup- Create new groupCreateChannel- Create new channelJoinChatByInvite- Join via invite link
Users
GetMe- Get current user infoGetUserInfo- Get user detailsGetContacts- List contactsAddContact- Add new contactBlockUser- Block userUnblockUser- Unblock user
🐳 Docker Deployment
docker-compose.yml
version: '3.8'
services:
45telega:
image: ghcr.io/sergekostenchuk/45telega:latest
restart: unless-stopped
ports:
- "8765:8765"
volumes:
- ./data:/data
- ./logs:/logs
env_file:
- .env
Run with Docker Compose
docker-compose up -d
docker-compose logs -f # View logs
docker-compose down # Stop
🔒 Security
- Non-root container: Runs as unprivileged user
- Environment variables: No hardcoded credentials
- Session encryption: Secure session storage
- Rate limiting: Built-in protection
- Health checks: Automatic recovery
📊 Monitoring
Health Check
curl http://localhost:8765/health
Prometheus Metrics
Enable in .env:
PROMETHEUS_ENABLED=true
PROMETHEUS_PORT=9090
Logging
Logs are stored in ./logs/ with rotation:
tail -f logs/45telega.log
🔄 Updates
Auto-update
45telega update
Manual Update
cd ~/.local/share/45telega
git pull
pip install -e . --upgrade
🧪 Development
Setup Development Environment
git clone https://github.com/sergekostenchuk/45telega
cd 45telega
pip install -e .[dev]
Run Tests
pytest tests/
pytest --cov=telega45 # With coverage
Code Quality
black . # Format code
ruff check . # Lint
mypy telega45 # Type check
🤝 Contributing
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing) - Open Pull Request
📝 License
MIT License - see LICENSE file.
💬 Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
🙏 Acknowledgments
Made with ❤️ by Sergey Kostenchuk