tgcli MCP server
Commit 12. Nov. 2026Ermöglicht es einem AI-Client, Telegram-Nachrichten über einen persönlichen Account via MTProto zu suchen, zu archivieren und zu versenden.
Auch bekannt als kfastov/tgcli
- Stars
- 45
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 12. Nov. 2026
- Lizenz
- MIT
Was ist tgcli MCP?
tgcli ist ein MCP server. Ermöglicht es einem AI-Client, Telegram-Nachrichten über einen persönlichen Account via MTProto zu suchen, zu archivieren und zu versenden.
Zusammenfassung generiert aus dem README des Projekts
Über tgcli MCP server
Mit tgcli kannst du deine persönliche Telegram-Kommunikation über einen AI-Client verwalten. Dieses Tool erlaubt es dir, Nachrichten über das MTProto-Protokoll anstatt der standardmäßigen Bot API zu suchen, zu archivieren und zu versenden. Es läuft lokal auf deiner Maschine und benötigt deine eigenen Telegram api_id und api_hash, die du über das Telegram Developer Portal erhältst, um deinen persönlichen Account zu authentifizieren.
Entwickler können die MCP Funktionalität über die Config-Einstellungen aktivieren, um sie mit ihrem bevorzugten AI-Client zu verbinden. Sobald sie aktiv ist, läuft der Server auf einem lokalen Host und Port deiner Wahl, zum Beispiel 127.0.0.1:8080. Das System verwaltet Daten über einen lokalen Store, der eine Nachrichten-Datenbank und Session-Files enthält. Es unterstützt verschiedene spezifische Aufgaben wie das Verwalten von Group Topics, das Herunterladen von Medien, das Durchsuchen archivierter Nachrichten sowie das Handhaben von Channel Tags oder Metadaten.
Nutzer interagieren mit dem System über das tgcli Command Line Interface, um den Server zu starten oder Hintergrund-Sync-Services zu verwalten. Das Tool bietet spezialisierte Commands für Kontakte, Gruppen und Channel-Metadaten, um sicherzustellen, dass die AI eine umfassende Übersicht über deine Telegram-Umgebung hat.
Was du damit machen kannst
- 1Archivierte Nachrichten durchsuchenBitte die AI, eine bestimmte Information innerhalb deines archivierten Telegram-Verlaufs zu finden.
- 2Telegram-Nachrichten versendenGib deinem AI-Client den Befehl, eine Textnachricht oder eine Datei an einen bestimmten Kontakt oder Usernamen zu senden.
- 3Mediendateien herunterladenLass die AI Medieninhalte aus deinen Telegram-Chats abrufen und herunterladen.
- 4Forum-Topics verwaltenNutze die AI, um in spezifischen Topics innerhalb von Telegram-Foren zu navigieren oder mit ihnen zu interagieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarkfastov/tgcli is public and reachablegithub.com/kfastov/tgcli ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-12github.com/kfastov/tgcli ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehentgcli
Telegram CLI with background sync and an optional MCP server for your personal account (MTProto, not bot API).
Installation
npm install -g @kfastov/tgcli
brew install kfastov/tap/tgcli
Authentication
Get Telegram API credentials:
- Go to https://my.telegram.org/apps
- Log in with your phone number
- Create a new application
- Copy
api_idandapi_hash
Then authenticate:
tgcli auth
Quick start
tgcli auth
tgcli sync --follow
tgcli messages list --chat @username --limit 20
tgcli messages search "course" --chat @channel --source archive
tgcli send text --to @username --message "hello"
tgcli server
Commands
tgcli auth Authentication and session setup
tgcli config View and edit config
tgcli sync Archive backfill and realtime sync
tgcli server Run background sync service (MCP optional); stop, restart, logs
tgcli service Install/start/stop/status/logs for background service
tgcli channels List/search channels
tgcli messages List/search messages
tgcli send Send text or files
tgcli media Download media
tgcli topics Forum topics
tgcli tags Channel tags
tgcli metadata Channel metadata cache
tgcli contacts Contacts and people
tgcli groups Group management
tgcli doctor Diagnostics and sanity checks
Commands run through tgcli server, which the CLI starts on demand. After an upgrade, the next command of any kind replaces a server the CLI started itself, as soon as its backfill queue is empty. A server you started yourself with tgcli server or tgcli service keeps running the old code until you restart it; the CLI warns about this on stderr. tgcli server restart restarts the server on the CLI's version, tgcli server stop stops it, and tgcli server logs --follow shows its log.
Use tgcli [command] --help for details. Add --json for machine-readable output.
Once a day tgcli checks npm for a newer release in the background and, at a terminal, prints one line on stderr with the upgrade command (brew update && brew upgrade tgcli or npm i -g @kfastov/tgcli). Set TGCLI_NO_UPDATE_CHECK=1 to turn it off; see docs/cli.md.
MCP (optional)
Enable it via config:
tgcli config set mcp.enabled true
By default the server binds to http://127.0.0.1:8080/mcp. To change it:
tgcli config set mcp.host 127.0.0.1
tgcli config set mcp.port 8080
Then run tgcli server and point your client at the configured address.
Configuration & Store
The tgcli store lives in the OS app-data directory and contains config.json, sessions, and messages.db.
Override the location with TGCLI_STORE.
Legacy version: see MIGRATION.md.
Development
Run it from a clone with Node 22: npm ci, then node cli.js. See docs/development.md for tests and for trying a change on your own account.
tgcli MCP Fragen
Wie aktiviere ich den MCP server in tgcli?
Setze mcp.enabled über den config command auf true und starte dann tgcli server. Verbinde deinen Client anschließend mit der konfigurierten Adresse.
Welche Authentifizierung nutzt tgcli für Telegram?
Es nutzt Telegram API Credentials (api_id und api_hash) von my.telegram.org sowie den tgcli auth command für das Session-Setup.
Kann tgcli den Nachrichtenverlauf offline durchsuchen?
Ja, es archiviert Nachrichten durch Sync und kann diese aus dem lokalen Archiv durchsuchen.
Nutzt tgcli die Bot API?
Nein, es arbeitet über das MTProto-Protokoll mit deinem persönlichen Telegram-Account statt über die Bot API.