Repolode
chigwell

chigwell/telegram-mcp

TelethonベースのMCPサーバー。ClaudeやCursorなどのAIクライアントからTelegramのチャットを読み、グループを管理できます。

スター
1,850
フォーク
470
未解決の Issue
31
最終コミット
昨日

これは何?

Telegram MCP Serverは、Claude DesktopやCursorなどのMCP対応クライアントから、Telegramアカウント、チャット、メッセージ、連絡先、メディア、フォルダー、管理機能を利用できるようにするインテグレーションです。Telethonをベースに、チャットやグループ、メッセージ(送信、編集、転送、検索、投票、リアクション)、連絡先、メディア、プロフィールとプライバシー設定、Telegramフォルダーを操作する80以上のツールを提供します。

ラベルを使って複数のアカウントに振り分けられるほか、利用可能なツールを読み取り専用に制限したり、操作できるチャットを許可リストで限定したりできます。stdio、streamable HTTP、SSEで動作し、Groq、Telegram Premium、OpenAI互換エンドポイント、またはローカルのfaster-whisperモデルを使った音声メッセージの文字起こしにも対応しています。セッションは文字列または永続化できるSQLiteファイルに保存でき、SOCKS、HTTP、MTProxyのプロキシも利用できます。

AIエージェントによるメッセージの送信や変更には現実的なリスクが伴うため、読み取り専用モード、ファイル拡張子の許可リスト、ファイルアクセスを許可するルートの指定などの制御機能を備えています。

主な機能

  • 01チャット、グループ、メッセージ、連絡先、メディア、フォルダーを操作する80以上のMCPツールを提供します。
  • 02ラベルを使った複数のTelegramアカウントへの振り分けに対応します。
  • 03読み取り専用モードとツールごとの許可リストで、書き込み操作を制限できます。
  • 04Groq、Telegram Premium、OpenAI互換API、またはローカルのWhisperで音声メッセージを文字起こしできます。
  • 05stdio、streamable HTTP、SSEの各トランスポートで動作します。
  • 06SOCKS、HTTP、MTProxyのプロキシに対応します。

ユースケース

  • ClaudeやCursorで未読のTelegramメッセージを要約し、返信の下書きを作成する。
  • チャット履歴を検索して、AIアシスタント向けの情報を取得する。
  • 招待、権限設定、BANなどのグループ管理を自動化する。
  • HTTP経由で複数のコーディングエージェントのセッションから1つのTelegramサーバーを共有する。

クイックスタート

  1. 1

    リポジトリをクローンする

  2. 2

    uvで依存関係をインストールする

    uv sync
  3. 3

    サーバーを起動する

使う前に知っておきたいこと

  • Telegram API IDとハッシュが必要です。また、一部の機能にはTelegram Premiumが必要です。
  • 複数の文字起こしエンジンやリッチフォーマットは、有料サービスまたはAPIキーが必要なサービスに依存します。

トピック

よくある質問

telegram-mcp とは?
TelethonベースのMCPサーバー。ClaudeやCursorなどのAIクライアントからTelegramのチャットを読み、グループを管理できます。 Telegram MCP Serverは、Claude DesktopやCursorなどのMCP対応クライアントから、Telegramアカウント、チャット、メッセージ、連絡先、メディア、フォルダー、管理機能を利用できるようにするインテグレーションです。Telethonをベースに、チャットやグループ、メッセージ(送信、編集、転送、検索、投票、リアクション)、連絡先、メディア、プロフィールとプライバシー設定、Telegramフォルダーを操作する80以上のツールを提供します。
telegram-mcp は無料で使えますか?ライセンスは?
telegram-mcp は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
telegram-mcp は今もメンテナンスされていますか?
活発にメンテナンス中。telegram-mcp の最終コミットは 2026年10月19日 です。
telegram-mcp は何に使えますか?
ClaudeやCursorで未読のTelegramメッセージを要約し、返信の下書きを作成する。 チャット履歴を検索して、AIアシスタント向けの情報を取得する。 招待、権限設定、BANなどのグループ管理を自動化する。 HTTP経由で複数のコーディングエージェントのセッションから1つのTelegramサーバーを共有する。
telegram-mcp のインストール方法は?
リポジトリをクローンする uvで依存関係をインストールする: uv sync サーバーを起動する
telegram-mcp はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/chigwell/telegram-mcp

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト