Telegram Archive MCPとは？
GitHub ユーザー GeiserX の telegram-archive-mcp は、MCP クライアントを Telegram Archive のインスタンスにつなぎます。Telegram Archive は同じ作者によるセルフホスト型のバックアップツールで、1 つ以上の Telegram アカウントを SQLite か PostgreSQL にコピーし、Web ビューアーで表示します。MCP サーバーはこのビューアーとだけ通信し、ビューアーのユーザー名とパスワードで /api/login エンドポイントにサインインします。Telegram には一切接続しません。
12 個のツールと 4 個のリソースがあります。チャットとフォルダーの一覧、1 つのチャットまたは全チャットの検索、チャットをページ単位や 1 日単位で読むこと、特定のメッセージの前後の取得、フォーラムのトピックとピン留めメッセージの一覧、チャットごとの統計、添付写真をモデルが見られる画像として返すことができます。すべてのツールは読み取りのみで、例外は refresh_stats です。これはビューアーにアーカイブ統計の再計算を指示するもので、READ_ONLY=1 で非表示になります。Go で書かれ、ライセンスは GPL-3.0-or-later、npm、Docker、ビルド済みバイナリで配布されています。バージョン 0.4.2 は 2026 年 11 月 11 日に公開されました。
Telegram Archive MCPのインストール方法
npx -y telegram-archive-mcpTelegram Archive MCPは使う価値があるか？
重要な設計上の判断は、このサーバーが Telegram に決して触れないことです。読み取るのは Telegram Archive のビューアーで、そこにはすでに自分のディスク上にメッセージのコピーがあるため、エージェントがメッセージを送ったり、グループを抜けたり、Telegram のスパム対策を作動させたりすることはできません。暴走したモデルにできる最悪のことは読みすぎることと、唯一の書き込みである refresh_stats だけで、これはビューアーに統計を数え直させるにすぎません。
ツールは、人が実際にチャット履歴を探すやり方に合わせて作られています。全チャットの一括検索、自分のタイムゾーンでの 1 日分の読み取り、ヒットしたメッセージの前後の取得によって、ある火曜日にプロジェクトのグループで何が決まったか、といった問いに答えられます。フォーラムのトピックとフォルダーにも対応し、写真は 1,568 ピクセルに縮小して返されるので、誰かが投稿したスクリーンショットを画像対応モデルが読めます。
ネットワークの既定値は多くのコミュニティ製サーバーより優れています。stdio では何も待ち受けません。Streamable HTTP モードはループバックにバインドし、Origin ヘッダーを確認し、リクエストの大きさを制限し、それ以外のアドレスでは MCP_AUTH_TOKEN がなければ起動を拒否します。リリース 0.4.2 は、過大なリクエストでサーバーが落ちないよう、わざわざ Go 1.27.4 で再ビルドされました。
注意点：役に立つかどうかは 背後のアーカイブ次第で、それには手間がかかります。Telegram Archive には Docker Compose、Telegram の API ID とハッシュ、自分のアカウントでのログインが必要で、編集履歴と削除されたメッセージを他人のものも含めて保存します。MCP クライアントをそこに向けると、削除済みのものも含めてそれらのメッセージがクライアントの使うモデル提供元に送られます。プロジェクトも小規模で、MCP サーバーのスターは 13、Telegram Archive は 252、npm のダウンロードは直近 1 か月で約 2,100 回、人によるコミットはすべて 1 人のメンテナーによるものです。
結論：Telegram の履歴を自宅サーバーに置くとすでに決めているなら、それをアシスタントで検索できるようにする丁寧な方法です。管理者のログインを渡すのではなく、検索させたいチャットに限定したビューアーアカウントを作ってください。
真価を発揮する場面
クライアントと Telegram のグループで作業範囲を決めているフリーランスの開発者
3 か月前にクライアントが実際に何を承認したかを見つける
アシスタントにクライアントのグループで機能名を検索させ、前後のメッセージとその日のやり取りを読ませます。延々とスクロールする代わりに数秒で済み、費用はアーカイブを動かすサーバーだけです。
メンバー 5,000 人のフォーラム型 Telegram グループのモデレーター
1 週間見逃したメンバーのために、活発なトピックを要約する
グループのフォーラムトピックを一覧し、選んだトピックをページごとに読ませ、モデルに要約を下書きさせます。エージェントが個人チャットを読めないよう、そのグループに限定したビューアーアカウントを使います。
公開 Telegram チャンネルをアーカイブしている研究者
ある主張が複数のチャンネルで最初に現れた時期をたどる
アーカイブ済みの全チャットでその言い回しを検索し、各ヒットを文脈とともに読み、日付を比べます。アーカイブが保存している編集と削除から、投稿が公開後に変わったかどうかがわかります。
導入前に確認すること
- 導入
- まず Telegram Archive を動かします（Docker Compose、Telegram の api_id と api_hash、1 回だけのログイン）。次に TELEGRAM_ARCHIVE_URL、TELEGRAM_ARCHIVE_USER、TELEGRAM_ARCHIVE_PASS を指定して npx -y telegram-archive-mcp を追加します。Claude Code、Claude Desktop、Cursor、VS Code、Codex 向けの設定例があります。
- 連携
- stdio または Streamable HTTP で 12 個のツールと 4 個のリソースを提供し、MCP のリビジョン 2024-11-05 から 2026-07-28 までに対応します。チェックサムで検証したバイナリをダウンロードする npm パッケージ、Docker イメージ、複数プラットフォーム向けの Go バイナリとして配布されています。
- データとプライバシー
- アーカイブは自分のディスクに残りますが、ツールが返すメッセージ、写真、統計はすべてモデルの提供元に渡ります。ビューアーのユーザー名とパスワードはクライアントの環境変数に置かれます。HTTP モードはループバックにバインドし、Origin を確認し、それ以外のアドレスでは MCP_AUTH_TOKEN を必須にします。
- 大規模利用時のコスト
- 無料です。費用はアーカイブのホストとストレージで、保存するメディアに応じて増えます。Telegram Archive は指定したサイズを超えるファイルを保存しないよう設定できます。
- 制限
- 読み取りアクセスのみで、Telegram で何かを送信、編集、削除することはできません。検索の質は Telegram Archive 自体の検索に左右されます。セキュリティ修正を受けられるのは最新リリースだけです。
良い点
- Telegram には接続せず、ローカルのアーカイブを読む
- 統計ツール 1 つを除いて読み取り専用で、それも READ_ONLY=1 で隠せる
- 1 日単位の閲覧とチャット横断検索
- HTTP モードはトークンなしでループバック以外のアドレスを拒否
気になる点
- 稼働中の Telegram Archive インスタンスが必要
- アーカイブ済みや削除済みのメッセージがモデル提供元に渡る
- メンテナーは 1 人で利用者も少ない
- ビューアーのパスワードがクライアント設定に置かれる
おすすめの人
すでに Telegram Archive をセルフホストしていて、保存したチャットの検索と要約をアシスタントに任せたい人。
Telegram Archive MCPの代替
Telegram Archive MCP：よくある質問
- Telegram Archive MCPは使う価値があるか？
- 自分の Telegram の履歴を覗く、整ったほぼ完全な読み取り専用の窓です。ただし価値があるのは、すでに Telegram Archive を運用していて、チャットがモデルの提供元に渡ることを受け入れられる場合に限られます。 評価は5点満点中3.8点で す。
- Telegram Archive MCPの料金は？
- 無料のオープンソース（GPL-3.0-or-later）で、Telegram Archive も同様です。費用はアーカイブをホストするマシンだけです。
- Telegram Archive MCPの欠点は？
- 稼働中の Telegram Archive インスタンスが必要; アーカイブ済みや削除済みのメッセージがモデル提供元に渡る; メンテナーは 1 人で利用者も少ない; ビューアーのパスワードがクライアント設定に置かれる.
- Telegram Archive MCPは誰に向いているか？
- すでに Telegram Archive をセルフホストしていて、保存したチャットの検索と要約をアシスタントに任せたい人。
- チームや本番環境でTelegram Archive MCPを使うと費用はいくらか？
- 無料です。費用はアーカイブのホストとストレージで、保存するメディアに応じて増えます。Telegram Archive は指定したサイズを超えるファイルを保存しないよう設定できます。
- Telegram Archive MCPは企業データを扱っても安全か？
- アーカイブは自分のディスクに残りますが、ツールが返すメッセージ、写真、統計はすべてモデルの提供元に渡ります。ビューアーのユーザー名とパスワードはクライアントの環境変数に置かれます。HTTP モードはループバックにバインドし、Origin を確認し、それ以外のアドレスでは MCP_AUTH_TOKEN を必須にします。
- Telegram Archive MCPの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はSlack MCP Server 、 Paperless-NGX MCP Serverです。
回答確認日：2026年11月13日