Telegram MCP Server

KR: Telegram Bot API를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다. 메시지 전송 및 최근 업데이트 내역 조회를 지원합니다. EN: This server exposes Telegram Bot APIs as MCP (Model Context Protocol) tools. It supports sending messages and fetching recent updates.

KR: 텔레그램 봇을 통해 실시간 알림을 보내거나 사용자의 응답을 읽어오는 워크플로우를 구성할 수 있습니다. EN: You can configure workflows to send real-time notifications or read user responses via a Telegram bot.

1) 인코딩 / Encoding

• KR: 이 문서는 UTF-8 기준입니다.
• EN: This document is written in UTF-8.

2) 환경 변수 / Environment Variables

필수 옵션 / Required Options

• TELEGRAM_BOT_TOKEN (필수/Required): BotFather로부터 발급받은 API 토큰

선택 옵션 / Optional Options

• PORT (선택/Optional): HTTP 모드 사용 시 서버가 바인딩할 포트 (기본값: 3000)
• TRANSPORT (선택/Optional): 서버 통신 방식 (stdio 또는 http, 기본값: stdio)

3) 실행 / Run

npm install
npm run build
npm start

4) MCP 서버 설정 / MCP Server Configuration

npx 설정 / npx Configuration

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "mcp-telegram"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-telegram-bot-token"
      }
    }
  }
}

5) 도구 분류 / Tool Categories

A. Telegram 봇 통신 / Telegram Bot Communication

1. telegram_send_message

• KR: 특정 채팅/유저에게 텍스트 메시지 발송
• EN: Send a text message to a specific chat/user.
• 인자 / Args: chat_id (required), text (required)

2. telegram_get_updates

• KR: 봇이 수신한 최근 메시지/이벤트 내역 조회
• EN: Fetch recent messages/events received by the bot.
• 인자 / Args: 없음 / None