Better Telegram MCP

mcp-name: io.github.n24q02m/better-telegram-mcp

Bot API(httpx)를 통한 빠른 봇 통합과 MTProto(Telethon)를 통한 전체 사용자 계정 액세스를 지원하는 듀얼 모드 Telegram MCP 서버입니다.

기능

• 듀얼 모드 -- 봇을 위한 Bot API(httpx), 사용자 계정을 위한 MTProto(Telethon)

• 6개의 도구 (액션 디스패치 포함): message, chat, media, contact, config, help

• 자동 모드 감지 -- 봇 모드용 봇 토큰 또는 사용자 모드용 API 자격 증명 설정

• 웹 기반 OTP 인증 -- 헤드리스 환경을 위한 원격 릴레이 지원 및 브라우저 기반 인증

• 도구 주석 -- 각 도구는 readOnlyHint, destructiveHint, idempotentHint, openWorldHint를 선언함

• MCP 리소스 -- telegram://docs/* 리소스로 문서 제공

• 보안 강화 -- SSRF 보호, 경로 탐색 방지, 오류 메시지 정제

설정

AI 에이전트 사용 시 -- 다음 내용을 복사하여 AI 에이전트에게 전달하세요:

Please set up better-telegram-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

수동 설정 -- docs/setup-manual.md를 따르세요.

도구

MCP 리소스

보안

• SSRF 보호 -- 모든 URL은 내부/사설 IP 대역에 대해 검증되며, DNS 리바인딩 차단됨

• 경로 탐색 방지 -- 파일 경로 검증 및 민감한 디렉토리 접근 차단

• 세션 파일 보안 -- 600 권한 설정, 웹 UI를 통한 2FA만 허용 (환경 변수에 절대 저장되지 않음)

• 오류 정제 -- 오류 메시지에 자격 증명이 절대 노출되지 않음

소스 빌드

git clone https://github.com/n24q02m/better-telegram-mcp.git
cd better-telegram-mcp
uv sync
uv run better-telegram-mcp

라이선스

MIT -- LICENSE를 참조하세요.