S4

sergekostenchuk/45telega

Developer tools

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

24 stars 5 forks 품질 77 트렌드 15MIT

텔레그램 MCP 서버 45+ 방법, QR auth, WSL/Kiro 설정 및 Docker-ready 배포

개요

강력한 모델 Context Protocol (MCP) 서버는 Telegram을 45 개 이상의 방법, 생산 읽기 배포 및 엔터프라이즈 기능을 제공합니다. - : 메시지, 채팅, 사용자, 미디어에 대한 완전한 API 적용 - : Docker 지원, 건강 검사, 모니터링, 로깅 - : Non-root 컨테이너, 환경 기반 구성, 세션 암호화 - : Async 아키텍처, Redis 캐싱, 연결 풀 - : One-line 설치, 자동 업데이트, 여러 배포 옵션 WSL 및 Kiro IDE와의 Windows 사용자를위한 종합 단계별 가이드. - Python 3.9+ 또는 Docker - my.telegram.org에서 Telegram API 자격 증명 - 512MB RAM 최소 - Linux/macOS/Windows (WSL 포함) 1. my.telegram.org 2. 전화 번호로 로그인 3. 새로운 응용 프로그램 만들기 4. 복사 api id 및 api hash 편집 ~/Library/Application Support/Claude/claude desktop config.json: 상세한 Kiro IDE 통합 지침에 대한 Windows Setup 가이드를 참조하십시오.

개요(AI 번역)

강력한 모델 Context Protocol (MCP) 서버는 Telegram을 45 개 이상의 방법, 생산 읽기 배포 및 엔터프라이즈 기능을 제공합니다.

✨ 특징

  • 45+ 전보 방법: 메시지, 채팅, 사용자, 미디어에 대한 API 적용 완료 -Production Ready: Docker 지원, 건강 검사, 모니터링, 로깅
  • Secure: Non-root 컨테이너, 환경 기반 구성, 세션 암호화
  • Scalable: Async 아키텍처, Redis 캐싱, 연결 풀링 -Easy Install: One-line 설치, 자동 업데이트, 여러 배포 옵션

⭐ 빠른 시작

플랫폼 - 특정 설정

윈도우 + WSL + 키로 IDE

** Windows 설치 가이드 →**

WSL 및 Kiro IDE와의 Windows 사용자를위한 종합 단계별 가이드.

####는 리눅스/macOS를 냉각합니다

One-Line 설치

PyPI 설치

Docker 설치

Pre Pre

  • 파이썬 3.9+ 또는 도커
  • my.telegram.org에서 Telegram API 자격 증명
  • 512MB RAM 최소
  • Linux/macOS/Windows (WSL 포함)

₢ 킹

##1. Telegram API Credentials 받기

  1. my.telegram.org로 이동
  2. 전화 번호로 로그인
  3. 새 신청서 작성
  4. 복사 api_id 및 api_hash

##2. 환경 구성

복사 `.env.

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

README

원문 README의 일부입니다. 원문 보기.

🚀 45telega - Production-Ready Telegram MCP Server

A powerful Model Context Protocol (MCP) server for Telegram with 45+ methods, production-ready deployment, and enterprise features.

✨ Features

  • 45+ Telegram Methods: Complete API coverage for messages, chats, users, media
  • Production Ready: Docker support, health checks, monitoring, logging
  • Secure: Non-root container, environment-based config, session encryption
  • Scalable: Async architecture, Redis caching, connection pooling
  • Easy Install: One-line installation, auto-updates, multiple deployment options

🚀 Quick Start

Platform-Specific Setup

🪟 Windows + WSL + Kiro IDE

📖 Complete Windows Setup Guide →

Comprehensive step-by-step guide for Windows users with WSL and Kiro IDE integration.

🐧 Linux/macOS

One-Line Install

curl -sSL https://raw.githubusercontent.com/sergekostenchuk/45telega/main/install.sh | bash

PyPI Install

pip install 45telega

Docker Install

docker run -d \
  --name 45telega \
  -p 8765:8765 \
  -e TELEGRAM_API_ID=your_api_id \
  -e TELEGRAM_API_HASH=your_api_hash \
  -v $(pwd)/data:/data \
  ghcr.io/sergekostenchuk/45telega:latest

📋 Prerequisites

  • Python 3.9+ or Docker
  • Telegram API credentials from my.telegram.org
  • 512MB RAM minimum
  • Linux/macOS/Windows (with WSL)

🔧 Configuration

1. Get Telegram API Credentials

  1. Go to my.telegram.org
  2. Login with your phone number
  3. Create new application
  4. Copy api_id and api_hash

2. Configure Environment

Copy .env.example to .env:

cp ~/.config/45telega/.env.example ~/.config/45telega/.env

Edit with your credentials:

TELEGRAM_API_ID=your_api_id_here
TELEGRAM_API_HASH=your_api_hash_here
TELEGRAM_PHONE=+1234567890  # Optional

3. First Authentication

45telega sign-in --phone +1234567890

Enter the code you receive on Telegram.

🎯 Usage

Start MCP Server

# Native
45telega run

# Docker
docker-compose up -d

# With custom port
45telega run --port 9000

Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "45telega": {
      "type": "stdio",
      "command": "/Users/you/.local/bin/45telega",
      "args": ["run"],
      "env": {
        "TELEGRAM_API_ID": "your_api_id",
        "TELEGRAM_API_HASH": "your_api_hash"
      }
    }
  }
}

Add to Kiro IDE (Windows + WSL)

GitHub에서 전체 README 보기

설치

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

설정

{ "mcpServers": { "45telega": { "type": "stdio", "command": "/Users/you/.local/bin/45telega", "args": ["run"], "env": { "TELEGRAM_API_ID": "your_api_id", "TELEGRAM_API_HASH": "your_api_hash" } } } }