강력한 MCP (Model Context Protocol) 서버는 텔레그램 채널 및 그룹과 상호 작용할 수 있는 Claude를 가능하게 합니다. 이 서버는 Telegram 콘텐츠에 웹 스크랩 및 직접 API 액세스를 제공합니다.

♨ 특징

버전 0.3.0 - 듀얼 모드 작동

API 모드 (추천) ⚡

• **100x 더 빠른 ** 웹 스크랩보다
• Telegram의 MTProto 프로토콜을 통한 직접 액세스
• 채널 내 검색 기능
• 개인 채널에 액세스 당신은 회원입니다
• 전체 메시지 메타데이터 (보기, 반응, 전달)
• Persistent 세션 - 한 번 인증
• 필요한 브라우저 자동화 없음 -Unlimited post retrieval 기본

웹 스크램핑 모드

• 요구되는 API 자격
• Puppeteer와 브라우저 기반 스크랩
• 제한된 콘텐츠에 대한 인증 지원
• Visual 미디어 추출
• 빠른, 익명 액세스를 위해 적합

Pre Pre

• Node.js 18.0.0 이상
• Chrome/Chromium (웹 스크랩 모드 용)
• Telegram API 자격 증명 (API 모드 용) - 여기를 클릭하십시오

672️ 설치

1. Clone 이 저장소:

2. 의존성 설치:

3. 예제 환경 파일을 복사 :

4. .env 편집 및 구성 추가:

Telegram MCP Server

A powerful MCP (Model Context Protocol) server that enables Claude to interact with Telegram channels and groups. This server provides both web scraping and direct API access to Telegram content.

🚀 Features

Version 0.3.0 - Dual Mode Operation

API Mode (Recommended) ⚡

• 100x faster than web scraping
• Direct access via Telegram’s MTProto protocol
• Search functionality within channels
• Access to private channels you’re a member of
• Complete message metadata (views, reactions, forwards)
• Persistent sessions - authenticate once
• No browser automation needed
• Unlimited post retrieval by default

Web Scraping Mode 🌐

• No API credentials required
• Browser-based scraping with Puppeteer
• Authentication support for restricted content
• Visual media extraction
• Suitable for quick, anonymous access

📋 Prerequisites

• Node.js 18.0.0 or higher
• Chrome/Chromium (for web scraping mode)
• Telegram API credentials (for API mode) - Get them here

🛠️ Installation

1. Clone this repository:

git clone https://github.com/DLHellMe/telegram-mcp-server.git
cd telegram-mcp-server

2. Install dependencies:

npm install

3. Copy the example environment file:

cp .env.example .env

4. Edit .env and add your configuration:

   • For API mode: Add your TELEGRAM_API_ID and TELEGRAM_API_HASH
   • For web scraping: Default settings work out of the box

5. Build the project:

npm run build

🔧 Configuration

Getting Telegram API Credentials

1. Go to https://my.telegram.org
2. Log in with your phone number
3. Click “API development tools”
4. Create a new application
5. Copy your api_id and api_hash to the .env file

Claude Desktop Configuration

Add this to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "telegram-scraper": {
      "command": "node",
      "args": ["/absolute/path/to/telegram-mcp-server/dist/index.js"],
      "env": {
        "TELEGRAM_API_ID": "your_api_id",
        "TELEGRAM_API_HASH": "your_api_hash"
      }
    }
  }
}

📖 Usage

After configuration, restart Claude Desktop. The Telegram tools will be available in Claude.

API Mode Tools

1. telegram_api_login - Authenticate with Telegram (first time only)

   Use telegram_api_login to connect to Telegram
   

2. api_scrape_channel - Scrape channel posts (unlimited by default)

   Use api_scrape_channel with url="https://t.me/channelname"
   

   Or with a limit:

   Use api_scrape_channel with url="https://t.me/channelname" and max_posts=50
   

3. api_search_channel - Search within a channel