Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaRelated ServersScoreDiscussions
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

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 installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/n24q02m/better-telegram-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server