Telegram MCP Server

tgcli

個人アカウント向けのバックグラウンド同期機能とオプションの MCP サーバーを備えた Telegram CLI です（ボット API ではなく MTProto を使用）。

インストール

npm install -g @kfastov/tgcli

brew install kfastov/tap/tgcli

認証

Telegram API の認証情報を取得します。

1. https://my.telegram.org/apps にアクセスします
2. 電話番号でログインします
3. 新しいアプリケーションを作成します
4. api_id と api_hash をコピーします

次に、認証を行います。

tgcli auth

クイックスタート

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

コマンド

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)
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

詳細については、tgcli [command] --help を使用してください。機械可読な出力にするには --json を追加します。

MCP（任意）

設定で有効にします。

tgcli config set mcp.enabled true

デフォルトでは、サーバーは http://127.0.0.1:8080/mcp にバインドします。変更するには、次のようにします。

tgcli config set mcp.host 127.0.0.1
tgcli config set mcp.port 8080

次に tgcli server を実行し、設定したアドレスをクライアントに指定します。

設定とストア

tgcli のストアは OS のアプリデータディレクトリにあり、config.json、セッション、messages.db が含まれます。 場所を変更するには TGCLI_STORE を使用します。

以前のバージョンについては、MIGRATION.md を参照してください。