CT

chaindead/telegram-mcp

Developer tools

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

349 stars 59 forks 품질 81 트렌드 23MIT

대화, 메시지, 초안, 읽음 상태 등 다양한 기능을 관리하는 텔레그램 MCP입니다.

개요

서버는 텔레그램 API와 AI 어시스턴트 사이의 다리 역할을 하며, 모델 컨텍스트 프로토콜(Model Context Protocol)을 기반으로 합니다. 이 서버를 사용하기 전에 Telegram API 이용 약관을 읽고 이해했는지 반드시 확인하세요. Telegram API를 오용할 경우 계정이 정지될 수 있습니다. 모델 컨텍스트 프로토콜(MCP)은 Claude Desktop이나 Cursor와 같은 AI 앱이 외부 도구와 데이터 소스에 연결될 수 있도록 하는 시스템입니다. 이 프로토콜은 AI 보조가 로컬 서비스와 API를 명확하고 안전하게 다루면서 사용자가 직접 제어할 수 있도록 돕습니다.

개요(AI 번역)

서버는 텔레그램 API와 AI 어시스턴트 사이의 다리 역할을 하며, 모델 컨텍스트 프로토콜(Model Context Protocol)을 기반으로 합니다.

[! 중요] 이 서버를 사용하기 전에 Telegram API 이용 약관을 읽고 이해했는지 확인하세요. 텔레그램 API를 악용할 경우 계정 정지가 발생할 수 있습니다.

목차

  • MCP가 뭐야?
  • 이 서버는 뭐 하는 거야?
  • 역량
  • 프롬프트 예시
  • 메시지 관리
  • 조직
  • 커뮤니케이션
  • 설치
  • 홈브류
  • NPX
  • 릴리스 중
  • 맥OS
  • 리눅스
  • 윈도우
  • 출처에서
  • 구성
  • 승인
  • 클라이언트 구성
  • JSON 스키마 버전
  • 스타 역사

MCP란 무엇인가?

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop이나 Cursor와 같은 AI 앱이 외부 도구와 데이터 소스에 연결될 수 있도록 하는 시스템입니다. 이 프로토콜은 AI 보조가 로컬 서비스와 API를 명확하고 안전하게 다루면서 사용자가 직접 제어할 수 있도록 돕습니다.

이 서버는 무엇을 하는 걸까요?

능력

  • [x] 현재 계좌 정보 (tool: tg_me)
  • [x] 선택적 읽지 않은 필터가 있는 리스트 대화 대화 (tool: tg_dialogs)
  • [x] 대화를 읽음으로 표시하세요 (tool: tg_read)

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

README

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

Telegram MCP server

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

Table of Contents

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do?

Capabilities

  • [x] Get current account information (tool: tg_me)
  • [x] List dialogs with optional unread filter (tool: tg_dialogs)
  • [x] Mark dialog as read (tool: tg_read)
  • [x] Retrieve messages from specific dialog (tool: tg_dialog)
  • [x] Send draft messages to any dialog (tool: tg_send)

Prompt examples

Here are some example prompts you can use with AI assistants:

Message Management

  • “Check for any unread important messages in my Telegram”
  • “Summarize all my unread Telegram messages”
  • “Read and analyze my unread messages, prepare draft responses where needed”
  • “Check non-critical unread messages and give me a brief overview”

Organization

  • “Analyze my Telegram dialogs and suggest a folder structure”
  • “Help me categorize my Telegram chats by importance”
  • “Find all work-related conversations and suggest how to organize them”
GitHub에서 전체 README 보기

설치

npx -y @chaindead/telegram-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "@chaindead/telegram-mcp"], "env": { "TG_APP_ID": "<your-api-id>", "TG_API_HASH": "<your-api-hash>" } } } }