Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Better Telegram MCP

mcp-name: io.github.n24q02m/better-telegram-mcp

MCP-Server für Telegram mit Dual-Mode-Unterstützung: Bot-API (httpx) für schnelle Bot-Integrationen und MTProto (Telethon) für vollen Benutzerkonto-Zugriff.

CI codecov PyPI Docker License: MIT

Python Telegram MCP semantic-release Renovate

Funktionen

  • Dual-Mode -- Bot-API (httpx) für Bots, MTProto (Telethon) für Benutzerkonten

  • 6 Tools mit Aktions-Dispatch: message, chat, media, contact, config, help

  • Auto-Erkennungsmodus -- Bot-Token für Bot-Modus oder API-Anmeldedaten für Benutzermodus festlegen

  • Webbasierte OTP-Authentifizierung -- Browserbasierte Authentifizierung mit Remote-Relay-Unterstützung für Headless-Umgebungen

  • Tool-Annotationen -- Jedes Tool deklariert readOnlyHint, destructiveHint, idempotentHint, openWorldHint

  • MCP-Ressourcen -- Dokumentation als telegram://docs/* Ressourcen verfügbar

  • Sicherheitsgehärtet -- SSRF-Schutz, Verhinderung von Pfad-Traversal, Fehler-Sanitisierung

Related MCP server: Telegram MCP Server & Channel Monitor

Einrichtung

Mit KI-Agent -- kopieren Sie dies und senden Sie es an Ihren KI-Agenten:

Bitte richten Sie better-telegram-mcp für mich ein. Folgen Sie dieser Anleitung: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

Manuelle Einrichtung -- folgen Sie docs/setup-manual.md

Tools

Tool

Aktionen

Beschreibung

message

send, edit, delete, forward, pin, react, search, history

Nachrichten senden, bearbeiten, löschen, weiterleiten. Pinnen, reagieren, suchen, Verlauf durchsuchen

chat

list, info, create, join, leave, members, admin, settings, topics

Chats, Gruppen und Kanäle auflisten und verwalten. Mitglieder, Admin, Forum-Themen

media

send_photo, send_file, send_voice, send_video, download

Fotos, Dateien, Sprachnachrichten, Videos senden. Medien aus Nachrichten herunterladen

contact

list, search, add, block

Kontakte auflisten, suchen, hinzufügen. Benutzer blockieren/entblocken (nur Benutzermodus)

config

status, set, cache_clear, setup_status, setup_start, setup_reset, setup_complete

Serverstatus, Laufzeiteinstellungen, Cache, Anmeldedaten-Einrichtung (Relay, Status, Reset, Abschluss)

help

--

Vollständige Dokumentation für jedes Thema

MCP-Ressourcen

URI

Inhalt

telegram://docs/messages

Referenz für Nachrichtenoperationen

telegram://docs/chats

Referenz für Chatverwaltung

telegram://docs/media

Referenz für Medienversand/-download

telegram://docs/contacts

Referenz für Kontaktverwaltung

telegram://stats

Gesamte Dokumentation zusammengefasst

Sicherheit

  • SSRF-Schutz -- Alle URLs werden gegen interne/private IP-Bereiche validiert, DNS-Rebinding wird blockiert

  • Verhinderung von Pfad-Traversal -- Dateipfade werden validiert, sensible Verzeichnisse blockiert

  • Sitzungsdateisicherheit -- 600-Berechtigungen, 2FA nur über Web-UI (wird niemals in Umgebungsvariablen gespeichert)

  • Fehler-Sanitisierung -- Anmeldedaten werden niemals in Fehlermeldungen preisgegeben

Aus Quellcode erstellen

git clone https://github.com/n24q02m/better-telegram-mcp.git
cd better-telegram-mcp
uv sync
uv run better-telegram-mcp

Lizenz

MIT -- Siehe LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • telegram-bot-mcp

    FantomaSkaRus1
    A
    license
    B
    quality
    C
    maintenance
    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.
    100
    31 npm
    7
    MIT

  • Telegram MCP Server & Channel

    ruchiayeon
    A
    license
    A
    quality
    D
    maintenance
    A comprehensive MCP server providing 35 tools for managing Telegram messages, media, and chat interactions via the Bot API. It also features a real-time monitoring system using the Telethon User API to log messages from specific channels.
    35
    Apache 2.0

  • tg-mcp-guarded

    matskevich
    A
    license
    Not graded
    quality
    C
    maintenance
    Dual-plane Telegram MCP server providing read-only analytics and guarded write actions with built-in rate limiting, anti-spam protection, and session management.
    9
    MIT