Better Telegram MCP

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

Bot API (httpx) による迅速なボット統合と、MTProto (Telethon) によるユーザーアカウントのフルアクセスを両立した、デュアルモード対応のTelegram用MCPサーバーです。

特徴

• デュアルモード -- ボット用のBot API (httpx) と、ユーザーアカウント用のMTProto (Telethon) に対応

• 6つのツール -- アクションディスパッチ機能付き: message, chat, media, contact, config, help

• 自動モード検出 -- ボットトークンを設定すればボットモード、API認証情報を設定すればユーザーモードとして動作

• WebベースのOTP認証 -- ブラウザベースの認証。ヘッドレス環境向けのリモートリレーをサポート

• ツールアノテーション -- 各ツールは readOnlyHint, destructiveHint, idempotentHint, openWorldHint を宣言

• MCPリソース -- ドキュメントを telegram://docs/* リソースとして利用可能

• セキュリティ強化 -- SSRF保護、パストラバーサル防止、エラーサニタイズを実装

セットアップ

AIエージェントを使用する場合 -- 以下をコピーしてAIエージェントに送信してください:

Please set up better-telegram-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

手動セットアップ -- docs/setup-manual.md に従ってください

ツール

MCPリソース

セキュリティ

• SSRF保護 -- すべてのURLは内部/プライベートIP範囲に対して検証され、DNSリバインディングをブロック

• パストラバーサル防止 -- ファイルパスを検証し、機密ディレクトリへのアクセスをブロック

• セッションファイルのセキュリティ -- 600パーミッションを設定。2FAはWeb UI経由のみ（環境変数には保存されません）

• エラーサニタイズ -- エラーメッセージに認証情報が含まれないように保護

ソースからのビルド

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

ライセンス

MIT -- LICENSE を参照してください。