chigwell/telegram-mcp

해결하는 문제

이 프로젝트는 AI 에이전트(Claude, Cursor 및 기타 MCP 호환 클라이언트 등)와 텔레그램 간의 다리 역할을 합니다. LLM이 사용자의 텔레그램 계정과 상호작용할 수 있게 하여 메시지 읽기 및 전송, 채팅 관리, 미디어 처리가 가능하게 하며, 실제로 텔레그램 계정을 AI 에이전트의 도구로 활용할 수 있게 합니다.

작동 방식

Model Context Protocol (MCP)를 구현하여 AI 에이전트에 80개 이상의 도구를 공개합니다. Telethon 라이브러리를 사용해 텔레그램 API와 통신합니다. Python 또는 Docker를 통해 로컬에서 서버를 실행할 수 있으며, stdio, streamable HTTP, SSE의 세 가지 전송 방식을 지원합니다. 특정 도구를 제한하는 보안 계층(예: 읽기 전용 모드)을 포함하며, 권한 없는 파일 접근을 방지하기 위해 엄격한 파일 경로 보안을 적용합니다.

대상 사용자

AI 워크플로우에 텔레그램 통신을 통합하고자 하는 MCP 호환 AI 에이전트 사용자, 또는 AI 어시스턴트가 텔레그램 계정과 메시지를 관리할 수 있도록 하고자 하는 개발자.

주요 특징

• 풍부한 도구 세트: 계정, 채팅, 메시지, 연락처, 미디어, 폴더 관리에 80개 이상의 도구 제공.
• 다중 계정 지원: 여러 텔레그램 계정 간에 도구 호출을 구성하고 라우팅 가능.
• 연락처 별칭: 연락처에 사용자 정의 이름을 '기억'하는 시스템으로 에이전트 상호작용을 더 자연스럽게.
• 유연한 전송 방식: 여러 클라이언트 간 공유 서버 사용을 위한 stdio, http, sse 지원.
• 세밀한 보안 설정: 도구를 읽기 전용 또는 특정 쓰기 허용 목록으로 제한할 수 있는 옵션.
• 실시간 이벤트: 콜백 방식 전달을 위한 인입 이벤트 피드(특히 Claude Code용).
• 프록시 지원: SOCKS, HTTP, MTProxy 내장 지원.