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을 활성화하여 텔레그램을 제어하세요

모델 컨텍스트 프로토콜(MCP)을 통해 대형 언어 모델을 텔레그램에 연결합니다.

Telethon으로 구축된 이 서버는 AI 에이전트가 텔레그램과 상호작용할 수 있게 해주며, 메시지 전송/편집/삭제, 채팅 검색, 초안 관리, 미디어 다운로드 등 MTProto를 통해 다양한 기능을 가능하게 합니다.

🚀 시작하기
선수 조건
설치
⚙️ 사용
로그인
MCP 서버에 접속
🧰 사용 가능한 도구
📨 메시징 도구
🔍 탐색 및 내비게이션
📝 드래프트 관리
📂 미디어 처리
🛠️ 문제 해결
🤝 기여
📝 면허

🚀 시작하기

전제 조건

Python 3.10 이상
uv 공식 UV 가이드를 통해 설치하세요.

설치

mcp-telegram CLI 도구를 설치하세요:

⚙️ 사용

[! 중요] 이 도구를 사용하기 전에 텔레그램의 이용 약관을 읽고 이해했는지 반드시 확인해 주세요. 이 도구를 오용할 경우 계정 제한이 발생할 수 있습니다.

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>"
      }
    }
  }
}