tgcli MCP sunucusu
Commit 12 Kas 2026Bir yapay zeka istemcisinin MTProto üzerinden kişisel bir hesapla Telegram mesajlarını aramasını, arşivlemesini ve göndermesini sağlar.
Ayrıca bilinen adı kfastov/tgcli
- Yıldızlar
- 45
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 12 Kas 2026
- Lisans
- MIT
tgcli MCP nedir?
Bir yapay zeka istemcisinin MTProto üzerinden kişisel bir hesapla Telegram mesajlarını aramasını, arşivlemesini ve göndermesini sağlar.
Özet, projenin README dosyasından oluşturuldu
tgcli MCP sunucusu hakkında
Kişisel Telegram iletişimini bir yapay zeka istemcisi üzerinden yönetmek tgcli ile mümkündür. Bu araç, kullanıcıların standart bot API yerine MTProto protokolünü kullanarak mesaj aramasına, arşivlemesine ve göndermesine olanak tanır. Yerel makinenizde çalışır ve kişisel hesabınızı doğrulamak için Telegram geliştirici portalından alınan kendi api_id ve api_hash bilgilerinize ihtiyaç duyar.
Geliştiriciler, MCP işlevselliğini tercih ettikleri yapay zeka istemcisine bağlamak için yapılandırma ayarları üzerinden etkinleştirebilirler. Aktif hale geldiğinde sunucu, 127.0.0.1:8080 gibi seçtiğiniz bir yerel host ve port üzerinde çalışır. Sistem, mesaj veritabanı ve oturum dosyalarını içeren yerel bir depolama aracılığıyla verileri yönetir. Grup konularını yönetmek, medya indirmek, arşivlenmiş mesajlarda arama yapmak ve kanal etiketleri veya meta verilerini işlemek gibi çeşitli özel görevleri destekler.
Kullanıcılar, sunucuyu başlatmak veya arka plan senkronizasyon hizmetlerini yönetmek için tgcli komut satırı aracılığıyla sistemle etkileşime girerler. Araç; yapay zekanın Telegram ortamınıza dair kapsamlı bir görüşe sahip olmasını sağlamak için kişiler, gruplar ve kanal meta verileri için özelleşmiş komutlar sunar.
Neler yapabilirsiniz
- 1Arşivlenmiş mesajları aramaYapay zekadan arşivlenmiş Telegram geçmişiniz içindeki belirli bir bilgiyi bulmasını isteyin.
- 2Telegram mesajları göndermeYapay zeka istemcinize belirli bir kişiye veya kullanıcı adına metin mesajı veya dosya göndermesi talimatını verin.
- 3Medya dosyalarını indirmeYapay zekanın Telegram sohbetlerinizden medya içeriği çekmesini ve indirmesini sağlayın.
- 4Forum konularını yönetmeTelegram forumlarındaki belirli konular arasında gezinmek veya bunlarla etkileşime geçmek için yapay zekayı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirkfastov/tgcli is public and reachablegithub.com/kfastov/tgcli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/kfastov/tgcli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
tgcli
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 soruları
tgcli içinde MCP server nasıl etkinleştirilir?
config komutu aracılığıyla mcp.enabled değerini true olarak ayarlayın, ardından tgcli server komutunu çalıştırın ve istemcinizi yapılandırılan adrese yönlendirin.
tgcli, Telegram için hangi kimlik doğrulamayı kullanır?
my.telegram.org üzerinden alınan Telegram API kimlik bilgilerini (api_id ve api_hash) ve oturum kurulumu için tgcli auth komutunu kullanır.
tgcli mesaj geçmişini çevrimdışı olarak arayabilir mi?
Evet, senkronizasyon yoluyla mesajları arşivler ve yerel arşiv üzerinden arama yapabilir.
tgcli bot API kullanıyor mu?
Hayır, bot API yerine MTProto üzerinden kişisel Telegram hesabınızla çalışır.