chigwell/telegram-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
TelethonによるTelegram MCPサーバーで、MCPクライアントがチャットを読み取ったり、グループを管理したり、メッセージ、メディア、連絡先、設定の送信・変更を行えます。
概要
Claude、Cursor、その他のMCP互換クライアント向けのTelegram統合です。Telethonを用いて、Telegramアカウント、チャット、メッセージ、連絡先、メディア、フォルダ、管理者操作をModel Context Protocolを通じて公開します。 クロードにチャット履歴の分析と返信を求める: サーバーには現在、以下のエリアにまとめられた80+ MCPツールが含まれています: - 設定済みアカウントの一覧とツール通話のルーティング(アカウントラベル)。- チャットの一覧、メタデータの検査、グループ/チャンネルの作成、チャットへの参加・退出、ユーザー招待、管理者管理、禁止、デフォルト権限、スローモード、トピック、招待リンク、共通チャット、既読確認、メッセージリンクの管理。- 送信、スケジュール、編集、削除、転送、ピン、ピン解除、既読、返信、検索、コンテキスト確認、投票作成、反応管理、インラインボタンのチェック、インラインコールバックの入力。- リスト、検索、追加、削除、ブロック解除、インポート、エクスポート、確認、直近の連絡先のやり取りの検索。
概要（AI 翻訳）
Claude、Cursor、その他のMCP互換クライアント向けのTelegram統合です。Telethonを用いて、Telegramアカウント、チャット、メッセージ、連絡先、メディア、フォルダ、管理者操作をModel Context Protocolを通じて公開します。
🤖 MCPの行動
Claudeにおける基本的なTelegram MCPの使用例:
クロードにチャット履歴の分析と返信を求める:
メッセージ送信成功:
内容
- スキルと実践的ワークフロー
- それができること
- 要件
- クイックスタート
- MCPクライアント構成
- マルチアカウント設定
- デバイス識別
- 期待口座チェック
- プロキシサポート
- ファイルパスセキュリティ
- チャットアクセスプライバシー(許可リスト)
- Docker
- 開発
- セキュリティノート
- トラブルシューティング
- ライセンス
スキルとワークフロー
すぐに使えるワークフロー、プロンプトの例、統合のレシピをお探しですか? 以下についてのステップバイステップガイドはスキルドキュメントをご覧ください。
- 未読メッセージの安全な要約
- 返信を送らずに作成すること
- アクションアイテムおよび緊急要望のトリアージ
- チャット履歴の検索とコンテキストの拡大
それができること
サーバーには現在、以下のエリアにまとめられた80+ MCPツールが含まれています:
- アカウント: 設定済みアカウントをリストし、ツール呼び出しをアカウントラベルでルーティングします。
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
A Telegram integration for Claude, Cursor, and other MCP-compatible clients. It exposes Telegram account, chat, message, contact, media, folder, and admin operations through the Model Context Protocol using Telethon.
🤖 MCP in Action
Basic Telegram MCP usage in Claude:
Asking Claude to analyze chat history and send a response:
Message sent successfully:
Contents
- Skills & Practical Workflows
- What It Can Do
- Requirements
- Quick Start
- MCP Client Configuration
- Multi-Account Setup
- Device Identity
- Expected Account Check
- Proxy Support
- File Path Security
- Chat Access Privacy (Allowlist)
- Docker
- Development
- Security Notes
- Troubleshooting
- License
Skills & Workflows
Looking for ready-to-use workflows, prompt examples, or integration recipes? Explore the Skills Documentation for step-by-step guides on:
- Summarizing unread messages safely
- Drafting replies without sending
- Triaging action items & urgent requests
- Searching chat history and expanding context
What It Can Do
The server currently includes 80+ MCP tools grouped into these areas:
- Accounts: list configured accounts and route tool calls by account label.
インストール
npx -y mcp-remote http://127.0.0.1:8765/mcp設定
{
"mcpServers": {
"telegram-mcp": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/telegram-mcp",
"run",
"main.py"
],
"env": {
"TELEGRAM_API_ID": "your_api_id_here",
"TELEGRAM_API_HASH": "your_api_hash_here",
"TELEGRAM_SESSION_STRING": "your_session_string_here"
}
}
}
}