dryeab/mcp-telegram

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

252 stars 40 forks 品質 63 トレンド 18MIT

Repository Install

dryeab/mcp-telegramは、[[T0]からインポートされたMCPサーバー候補です。

概要

dryeab/mcp-telegramは、[[T0]からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

LLMを有効にしてTelegramを制御する

大規模言語モデルをモデルコンテキストプロトコル(MCP)を介してTelegramに接続します。

Telethonで構築されたこのサーバーは、AIエージェントがTelegramとやり取りできるようになり、メッセージの送信・編集・削除、チャット検索、ドラフト管理、メディアダウンロードなどの機能がMTProtoを使って実現しています。

🚀 はじめかす
前提条件
設置
⚙️ 使用法
ログイン
MCPサーバーに接続
🧰 利用可能なツール
📨 メッセージングツール
🔍 検索・ナビゲーション
📝 ドラフト管理
📂 メディア処理
🛠️ トラブルシューティング
🤝 貢献
📝 ライセンス

🚀 始めて

前提条件

Python 3.10以降
uv 公式のUVガイドからインストールしてください。

就任

mcp-telegramのCLIツールをインストールしてください:

⚙️ 使用法

[!重要] このツールを使用する前に、必ずTelegramの利用規約を読み理解してください。このツールの誤用はアカウント制限の対象となる可能性があります。

mcp-telegramコマンドラインツールが入り口です。

README

以下は原文 README の抜粋です。原文を見る。

Connect Large Language Models to Telegram via the Model Context Protocol (MCP).

Built with Telethon, this server allows AI agents to interact with Telegram, enabling features like sending/editing/deleting messages, searching chats, managing drafts, downloading media, and more using the MTProto.

🚀 Getting Started

Prerequisites

Python 3.10 or higher
uv Install via the official uv guide.

Installation

Install the mcp-telegram CLI tool:

uv tool install mcp-telegram

⚙️ Usage

[!IMPORTANT] Please ensure you have read and understood Telegram’s ToS before using this tool. Misuse of this tool may result in account restrictions.

The mcp-telegram command-line tool is your entry point.

mcp-telegram --help # See all commands

First, authenticate with your Telegram account:

mcp-telegram login

This interactive command will prompt you for:

API ID & API Hash: Obtain these from my.telegram.org/apps.
Phone Number: Your Telegram-registered phone number (international format, e.g., +1234567890).
Verification Code: Sent to your Telegram account upon first login.
2FA Password: If you have Two-Factor Authentication enabled.

Your credentials are securely stored in the session file for future use.

[!WARNING] Keep your API credentials private and never share them publicly

[!NOTE]

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "mcp-telegram" /* Use full path if client can't find the command (e.g. "/usr/local/bin/mcp-telegram"). See IMPORTANT section below for full path instructions. */,
      "args": ["start"],
      "env": {
        "API_ID": "<your_api_id>",
        "API_HASH": "<your_api_hash>"
      }
    }
  }
}