chigwell/telegram-mcp

어떤 프로젝트인가요?

핵심 기능

• 01채팅, 그룹, 메시지, 연락처, 미디어, 폴더를 위한 80개 이상의 MCP 도구를 제공합니다.
• 02라벨에 따라 라우팅되는 여러 Telegram 계정을 지원합니다.
• 03쓰기 작업을 제한하는 읽기 전용 모드와 도구별 허용 목록을 제공합니다.
• 04Groq, Telegram Premium, OpenAI 호환 API 또는 로컬 Whisper를 통해 음성 메시지를 전사합니다.
• 05stdio, streamable HTTP 또는 SSE 전송 방식으로 실행할 수 있습니다.
• 06SOCKS, HTTP, MTProxy 프록시를 지원합니다.

활용 사례

• Claude나 Cursor가 읽지 않은 Telegram 메시지를 요약하고 답장 초안을 작성하도록 합니다.
• 채팅 기록을 검색하고 AI 어시스턴트에 필요한 맥락을 가져옵니다.
• 초대, 권한 설정, 차단 등 그룹 관리를 자동화합니다.
• 여러 코딩 에이전트 세션에서 HTTP를 통해 하나의 Telegram 서버를 공유합니다.

빠른 시작

1. 1

   저장소를 클론합니다

2. 2

   uv로 의존성을 설치합니다

   uv sync
3. 3

   서버를 실행합니다

사용 전 알아둘 점

• !Telegram API ID와 해시가 필요하며, 일부 기능에는 Telegram Premium이 필요합니다.
• !여러 전사 엔진과 서식 기능은 유료 서비스 또는 API 키가 필요한 서비스에 의존합니다.

토픽

자주 묻는 질문

telegram-mcp은(는) 무엇인가요?

Telethon 기반 MCP 서버로, Claude와 Cursor 같은 AI 클라이언트에서 Telegram 채팅을 읽고 그룹을 관리할 수 있습니다. Telegram MCP Server는 Claude Desktop, Cursor 등 MCP 호환 클라이언트에 Telegram 계정, 채팅, 메시지, 연락처, 미디어, 폴더 및 관리자 기능을 제공하는 통합 도구입니다. Telethon을 기반으로 하며 채팅과 그룹, 메시지(전송, 수정, 전달, 검색, 투표, 반응), 연락처, 미디어, 프로필 및 개인정보 설정, Telegram 폴더를 다루는 80개 이상의 도구를 제공합니다.

telegram-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

telegram-mcp은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

telegram-mcp은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. telegram-mcp의 마지막 커밋은 2026년 10월 19일입니다.

telegram-mcp은(는) 어디에 사용할 수 있나요?

Claude나 Cursor가 읽지 않은 Telegram 메시지를 요약하고 답장 초안을 작성하도록 합니다. 채팅 기록을 검색하고 AI 어시스턴트에 필요한 맥락을 가져옵니다. 초대, 권한 설정, 차단 등 그룹 관리를 자동화합니다. 여러 코딩 에이전트 세션에서 HTTP를 통해 하나의 Telegram 서버를 공유합니다.

telegram-mcp는 어떻게 설치하나요?

저장소를 클론합니다 uv로 의존성을 설치합니다: uv sync 서버를 실행합니다

telegram-mcp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/chigwell/telegram-mcp