Cherry Studio é um cliente de IA para desktop multiplataforma que se conecta a diversos provedores de LLM, modelos locais e mais de 300 assistentes predefinidos.
chigwell/telegram-mcp
Servidor MCP baseado em Telethon que permite a clientes de IA como Claude e Cursor ler conversas do Telegram e gerenciar grupos, mensagens, mídia e contatos.
- Estrelas
- 1,850
- Forks
- 470
- Issues abertas
- 31
- Último commit
- há 23 horas
O que é?
O Telegram MCP Server é uma integração que disponibiliza operações de conta do Telegram, conversas, mensagens, contatos, mídia, pastas e administração para clientes compatíveis com MCP, como Claude Desktop e Cursor. Desenvolvido com Telethon, oferece mais de 80 ferramentas para conversas e grupos, mensagens (enviar, editar, encaminhar, pesquisar, enquetes e reações), contatos, mídia, configurações de perfil e privacidade e pastas do Telegram.
O servidor oferece suporte a várias contas, selecionadas por rótulo, e pode ser limitado a um conjunto de ferramentas somente leitura ou a uma lista de conversas permitidas. Pode funcionar via stdio, HTTP com streaming ou SSE e inclui transcrição opcional de mensagens de voz usando Groq, Telegram Premium, endpoints compatíveis com OpenAI ou um modelo faster-whisper local. As sessões podem ser armazenadas como strings ou em arquivos SQLite persistentes, e há suporte a proxies SOCKS, HTTP e MTProxy.
Enviar e modificar mensagens por meio de um agente de IA envolve riscos reais, por isso o projeto oferece controles como modo somente leitura, listas de extensões de arquivo permitidas e diretórios autorizados para acesso a arquivos.
Recursos principais
- 01Disponibiliza mais de 80 ferramentas MCP para conversas, grupos, mensagens, contatos, mídia e pastas.
- 02Oferece suporte a várias contas do Telegram, selecionadas por rótulo.
- 03Oferece um modo somente leitura e listas de permissões por ferramenta para limitar operações de escrita.
- 04Transcreve mensagens de voz usando Groq, Telegram Premium, APIs compatíveis com OpenAI ou Whisper local.
- 05Funciona via transportes stdio, HTTP com streaming ou SSE.
- 06Oferece suporte a proxies SOCKS, HTTP e MTProxy.
Casos de uso
- Permitir que Claude ou Cursor resumam mensagens não lidas do Telegram e preparem respostas.
- Pesquisar o histórico de conversas e buscar contexto para um assistente de IA.
- Automatizar tarefas de administração de grupos, como convites, permissões e banimentos.
- Compartilhar um servidor do Telegram entre várias sessões de agentes de programação via HTTP.
Início rápido
- 1
Clone o repositório
- 2
Instale as dependências com uv
uv sync - 3
Execute o servidor
Antes de usar
- É necessário ter um ID e um hash da API do Telegram; alguns recursos também exigem o Telegram Premium.
- Vários mecanismos de transcrição e a formatação avançada dependem de serviços pagos ou que exigem uma chave de API.
Tópicos
Perguntas frequentes
- O que é telegram-mcp?
- Servidor MCP baseado em Telethon que permite a clientes de IA como Claude e Cursor ler conversas do Telegram e gerenciar grupos, mensagens, mídia e contatos. O Telegram MCP Server é uma integração que disponibiliza operações de conta do Telegram, conversas, mensagens, contatos, mídia, pastas e administração para clientes compatíveis com MCP, como Claude Desktop e Cursor. Desenvolvido com Telethon, oferece mais de 80 ferramentas para conversas e grupos, mensagens (enviar, editar, encaminhar, pesquisar, enquetes e reações), contatos, mídia, configurações de perfil e privacidade e pastas do Telegram.
- telegram-mcp é gratuito? Qual é a licença?
- telegram-mcp é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- telegram-mcp ainda é mantido?
- Manutenção ativa. O último commit de telegram-mcp foi em 19 de out. de 2026.
- Para que posso usar telegram-mcp?
- Permitir que Claude ou Cursor resumam mensagens não lidas do Telegram e preparem respostas. Pesquisar o histórico de conversas e buscar contexto para um assistente de IA. Automatizar tarefas de administração de grupos, como convites, permissões e banimentos. Compartilhar um servidor do Telegram entre várias sessões de agentes de programação via HTTP.
- Como instalar telegram-mcp?
- Clone o repositório Instale as dependências com uv: uv sync Execute o servidor
- Onde consigo telegram-mcp?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/chigwell/telegram-mcp
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Agente de programação para terminal com ferramentas integradas de LSP, debugger, navegador e subagentes, compatível com mais de 60 provedores de modelos.
Add-on do Blender e servidor MCP que permitem a assistentes de IA, como Claude, criar, modificar e inspecionar cenas 3D no Blender por meio de prompts.
Servidor MCP para agentes de programação com IA que mantém as saídas brutas das ferramentas fora da janela de contexto e preserva o estado da sessão após a compactação.
Servidor MCP com plugin nativo em C++ para Unreal Editor, que permite a assistentes de IA criar níveis, Blueprints, materiais e muito mais no editor em execução.
Conjunto de 23 plugins personalizados para hermes-agent, com recursos de autonomia, roteamento de modelos, telemetria, controle de custos, memória e comunicação entre agentes.