tolmachov/mcp-telegram

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

2 stars 5 forks 품질 75 트렌드 28MIT

MCP server for Telegram: read, search, send and summarize messages, manage chats and folders. Built in Go, with local stdio and multi-user HTTP support.

개요

- : List, search, mute/unmute chats, organise into folders - : Read, search, inspect context, send, draft, schedule, link-resolve, and backup messages - : Summarise chat conversations using multiple LLM providers - : separate versioned Keychain items on macOS; atomic 0600 session/config files in a 0700 state directory on Linux and Windows - : local (single account) or remote with an embedded OAuth 2.1 server and per-user Telegram QR login — multi-user and deployable to Cloud Run (see Remote (HTTP) Mode) 1. Go to my.telegram.org/apps 2. Create an application 3. Copy api_id and api_hash Store credentials (one versioned Keychain item per value on macOS; one atomic 0600 file per value in a 0700 state directory on Linux/Windows): Or export the current environment names explicitly: You'll be prompted for the verification code sent by Telegram and, when the account has two-step verification enabled, its 2FA password.

README

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

Features

Chat Management: List, search, mute/unmute chats, organise into folders
Messages: Read, search, inspect context, send, draft, schedule, link-resolve, and backup messages
AI Summarisation: Summarise chat conversations using multiple LLM providers
Secure storage: separate versioned Keychain items on macOS; atomic 0600 session/config files in a 0700 state directory on Linux and Windows
Two transports: local stdio (single account) or remote streamable HTTP with an embedded OAuth 2.1 server and per-user Telegram QR login — multi-user and deployable to Cloud Run (see Remote (HTTP) Mode)

Installation

go install github.com/tolmachov/mcp-telegram@latest

Or build from source:

git clone https://github.com/tolmachov/mcp-telegram.git
cd mcp-telegram
make

Setup

1. Get Telegram API Credentials

Go to my.telegram.org/apps
Create an application
Copy api_id and api_hash

2. Configure Environment

Store credentials (one versioned Keychain item per value on macOS; one atomic 0600 file per value in a 0700 state directory on Linux/Windows):

mcp-telegram config set api-id 123456789
mcp-telegram config set api-hash abcd1234efgh5678

Or export the current environment names explicitly:

export MCP_TELEGRAM_API_ID=123456789
export MCP_TELEGRAM_API_HASH=abcd1234efgh5678

mcp-telegram login --phone +1234567890

You’ll be prompted for the verification code sent by Telegram and, when the account has two-step verification enabled, its 2FA password.

If the code never arrives, log in with a QR code instead — no phone number or code needed:

mcp-telegram login --qr

The QR code is drawn in the terminal. Scan it from a signed-in Telegram app (Settings → Devices → Link Desktop Device); it refreshes on its own until scanned. The 2FA password, if any, is then asked for in the terminal.

4. Configure MCP Client

Claude Desktop

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

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

설정

{
  "mcpServers": {
    "telegram": {
      "command": "mcp-telegram",
      "args": ["run"],
      "env": {
        "MCP_TELEGRAM_API_ID": "your_api_id",
        "MCP_TELEGRAM_API_HASH": "your_api_hash"
      }
    }
  }
}