Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Better Telegram MCP

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

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

CI codecov PyPI Docker License: MIT

Python Telegram MCP semantic-release Renovate

特徴

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

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

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

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

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

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

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

Related MCP server: Telegram MCP Server & Channel Monitor

セットアップ

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 に従ってください

ツール

ツール

アクション

説明

message

send, edit, delete, forward, pin, react, search, history

メッセージの送信、編集、削除、転送。ピン留め、リアクション、検索、履歴の閲覧

chat

list, info, create, join, leave, members, admin, settings, topics

チャット、グループ、チャンネルのリスト表示と管理。メンバー、管理者、フォーラムトピックの管理

media

send_photo, send_file, send_voice, send_video, download

写真、ファイル、ボイスメモ、動画の送信。メッセージからのメディアダウンロード

contact

list, search, add, block

連絡先のリスト表示、検索、追加。ユーザーのブロック/ブロック解除（ユーザーモードのみ）

config

status, set, cache_clear, setup_status, setup_start, setup_reset, setup_complete

サーバー状態、実行時設定、キャッシュ、認証情報セットアップ（リレー、状態、リセット、完了）

help

--

あらゆるトピックに関する詳細ドキュメント

MCPリソース

URI

コンテンツ

telegram://docs/messages

メッセージ操作リファレンス

telegram://docs/chats

チャット管理リファレンス

telegram://docs/media

メディア送信/ダウンロードリファレンス

telegram://docs/contacts

連絡先管理リファレンス

telegram://stats

全ドキュメントの統合

セキュリティ

  • 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 を参照してください。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • telegram-bot-mcp

    FantomaSkaRus1
    A
    license
    B
    quality
    C
    maintenance
    Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.
    100
    31 npm
    7
    MIT

  • Telegram MCP Server & Channel

    ruchiayeon
    A
    license
    A
    quality
    D
    maintenance
    A comprehensive MCP server providing 35 tools for managing Telegram messages, media, and chat interactions via the Bot API. It also features a real-time monitoring system using the Telethon User API to log messages from specific channels.
    35
    Apache 2.0

  • tg-mcp-guarded

    matskevich
    A
    license
    Not graded
    quality
    C
    maintenance
    Dual-plane Telegram MCP server providing read-only analytics and guarded write actions with built-in rate limiting, anti-spam protection, and session management.
    9
    MIT