convez.ai
MCP ServerIntegração & APIsIntermediário
FantomaSkaRus1

Telegram Bot MCP Server

FantomaSkaRus1/telegram-bot-mcp

174 ferramentas para controlar bots Telegram via Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP completo para integração com Telegram Bot API, oferecendo 174 ferramentas para controlar bots via Claude Code e agentes IA. Cobre mensagens, chats, stickers, pagamentos, fóruns, stories e muito mais. Permite automação total de bots Telegram através de chamadas de função do Claude.

Instalação

$npx convez-ai FantomaSkaRus1/telegram-bot-mcp

1 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

Estrelas
7
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 8 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Automatizar fluxos de comunicação em grupos e canais Telegram
  • Criar bots inteligentes que usam Claude para processamento de linguagem
  • Integrar pagamentos e transações via Telegram Stars
  • Gerenciar comunidades com moderação automática e verificação

Veredito

MCP server robusto e bem documentado que abre acesso completo à Telegram Bot API pelo Claude. Cobertura abrangente de funcionalidades, mas exige conhecimento prévio de bots Telegram e tokens de autenticação.

README

A tradução para o português deste README ainda está na fila.

telegram-bot-mcp

Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.

Features

  • Messages — send (text, photo, video, audio, document, location, poll, dice, sticker, media groups), edit, forward, copy, delete, pin/unpin, reactions
  • Chats — info, settings, permissions, invite links, member management, verification
  • Bot — commands, profile, settings, description, menu button, admin rights
  • Stickers — create/edit/delete sticker sets, upload stickers, custom emoji
  • Payments — invoices, star transactions, gifts, refunds
  • Forums — create/edit/close/reopen/delete topics
  • Stories — post, edit, delete, repost
  • Business — business messages, accounts, connections
  • Games — send games, set scores, high scores
  • Webhooks — set, delete, get info

Quick Start

npm install

Claude Code

claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "telegram": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-telegram/index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_token"
      }
    }
  }
}

Environment Variables

VariableRequiredDescription
TELEGRAM_BOT_TOKENYesBot token from @BotFather
TELEGRAM_DEFAULT_CHAT_IDNoDefault chat ID (skip chat_id in tool calls)
TELEGRAM_DEFAULT_THREAD_IDNoDefault topic/thread ID for forum supergroups

Project Structure

index.js              # Entry point — registers all tool modules
utils/api.js          # Telegram API client, rate limiting, retry logic
tools/
  messages/           # send, edit, forward, manage
  chat/               # info, settings, invite, members, verify
  bot/                # core, commands, profile, settings
  stickers.js
  payments.js
  forum.js
  stories.js
  business.js
  games.js
  webhook.js

License

MIT

Ver o original no GitHub

Bom para

Relacionados