chigwell/telegram-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.9천 stars 486 forks 품질 90 트렌드 56Apache-2.0

Repository Install

텔레톤이 구동하는 텔레그램 MCP 서버로, MCP 클라이언트가 채팅을 읽고, 그룹을 관리하며, 메시지, 미디어, 연락처, 설정을 송수신/수정할 수 있게 합니다.

개요

Claude, Cursor 및 기타 MCP 호환 클라이언트를 위한 텔레그램 통합입니다. Telethon을 사용하여 Telegram 계정, 채팅, 메시지, 연락처, 미디어, 폴더, 관리자 작업을 모델 컨텍스트 프로토콜을 통해 노출합니다. 클로드에게 채팅 기록을 분석하고 답변을 보내달라고 요청하는 것: 서버에는 현재 80+ MCP 도구가 포함되어 있으며, 다음 영역으로 그룹화되어 있습니다: - 계정 라벨별로 지정된 계정 목록 및 도구 호출 경로 지정 - 채팅 목록 목록, 메타데이터 검사, 그룹/채널 생성, 채팅 참여 또는 종료, 사용자 초대, 관리자 관리, 차단, 기본 권한이 차단, 느린 모드, 주제, 초대 링크, 공통 채팅, 읽음 확인 및 메시지 링크 작성. - 전송, 예약, 편집, 삭제, 전달, 고정, 고정 해제, 읽음 표시, 답글 표시, 검색, 상황 확인, 설문조사 생성, 반응 관리, 인라인 버튼 검사, 인라인 콜백 입력 - 목록 작성, 검색, 추가, 삭제, 차단, 차단 해제, 가져오기, 내보내기, 직접 채팅 검사, 최근 연락처 상호작용 찾기.

개요(AI 번역)

Claude, Cursor 및 기타 MCP 호환 클라이언트를 위한 텔레그램 통합입니다. Telethon을 사용하여 Telegram 계정, 채팅, 메시지, 연락처, 미디어, 폴더, 관리자 작업을 모델 컨텍스트 프로토콜을 통해 노출합니다.

🤖 MCP 활동 중

Claude에서의 기본 텔레그램 MCP 사용법:

클로드에게 채팅 기록을 분석하고 답변을 보내달라고 요청하는 것:

메시지 전송 완료:

기술 및 워크플로우

즉시 사용할 수 있는 워크플로우, 프롬프트 예시, 또는 통합 레시피를 찾고 계신가요? 단계별 가이드는 기술 문서를 탐색해 보세요:

읽지 않은 메시지 안전하게 요약하기
답변을 보내지 않고 작성하는 것
실행 항목 및 긴급 요청 분류
채팅 기록 검색 및 맥락 확장

그것이 할 수 있는 일들

서버에는 현재 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:

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:

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.

GitHub에서 전체 README 보기

설치

npx -y mcp-remote http://127.0.0.1:8765/mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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