chigwell/telegram-mcp

何を解決するか

このプロジェクトは、AIエージェント（Claude、Cursor、およびその他のMCP互換クライアントなど）とTelegramの間の橋渡しを提供します。LLMがTelegramアカウントとやり取りできるようにし、メッセージの読み取りと送信、チャットの管理、メディアの扱いが可能になります。これにより、TelegramアカウントがAIエージェントのツールとして機能します。

動作方法

Model Context Protocol (MCP) を実装しており、AIエージェントに80以上のツールを公開しています。Telethonライブラリを使用してTelegram APIと通信しています。PythonまたはDockerでローカルでサーバーを実行でき、stdio、streamable HTTP、SSEの3つのトランスポート方法をサポートしています。特定のツールを制限するセキュリティ層（例：読み取り専用モード）を備えており、不正なファイルアクセスを防ぐために厳格なファイルパスセキュリティを実装しています。

対象ユーザー

Telegramの通信をAIワークフローに統合したいMCP互換AIエージェントのユーザー、およびAIアシスタントにTelegramアカウントとメッセージの管理能力を与える開発者。

主な特徴

• 豊富なツールセット： アカウント、チャット、メッセージ、連絡先、メディア、フォルダの管理に80以上のツールを提供。
• マルチアカウント対応： 複数のTelegramアカウント間でツール呼び出しを構成・ルーティング可能。
• 連絡先エイリアス： 連絡先にカスタム名を「記憶」する仕組みにより、エージェントとのやり取りをより自然に。
• 柔軟なトランスポート： 複数クライアント間で共有サーバーを使用するためのstdio、http、sseをサポート。
• 細かいセキュリティ： ツールを読み取り専用または特定の書き込み許可リストに制限できるオプション。
• リアルタイムイベント： イベントフィードを受信し、コールバック形式で通知（特にClaude Code向け）。
• プロキシ対応： SOCKS、HTTP、MTProxyを内蔵でサポート。