Repolode
chigwell

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. 1

    Clone o repositório

  2. 2

    Instale as dependências com uv

    uv sync
  3. 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