Telegram Archive MCP의 개요
GitHub 사용자 GeiserX의 telegram-archive-mcp는 MCP 클라이언트를 Telegram Archive 인스턴스에 연결합니다. Telegram Archive는 같은 작성자가 만든 자체 호스팅 백업 도구로, 하나 이상의 Telegram 계정을 SQLite나 PostgreSQL에 복사하고 웹 뷰어로 보여 줍니다. MCP 서버는 이 뷰어와만 통신하며, 뷰어 사용자 이름과 비밀번호로 /api/login 엔드포인트에 로그인합니다. Telegram에는 전혀 연결하지 않습니다.
도구 12개와 리소스 4개를 제공합니다. 대화와 폴더 목록, 한 대화 또는 전체 대화 검색, 대화를 페이지 단위나 하루 단위로 읽기, 특정 메시지 앞뒤 메시지 가져오기, 포럼 주제와 고정 메시지 목록, 대화별 통계, 첨부 사진을 모델이 볼 수 있는 이미지로 반환하기가 가능합니다. 모든 도구는 읽기만 하며, 예외인 refresh_stats는 뷰어에 보관 통계 재계산을 요청하고 READ_ONLY=1이면 사라집니다. Go로 작성되었고 GPL-3.0-or-later 라이선스이며 npm, Docker, 사전 빌드 바이너리로 배포됩니다. 버전 0.4.2는 2026년 11월 11일에 나왔습니다.
Telegram Archive MCP 설치 방법
npx -y telegram-archive-mcpTelegram Archive MCP, 쓸 만한 가치가 있습니까?
중요한 설계 결정은 이 서버가 Telegram에 절대 손대지 않는다는 점입니다. 이미 사용자 디스크에 메시지 사본을 보관하고 있는 Telegram Archive 뷰어에서 읽기 때문에, 에이전트는 메시지를 보내거나 그룹을 나가거나 Telegram의 스팸 방지 시스템을 건드릴 수 없습니다. 잘못 동작하는 모델이 할 수 있는 최악의 일은 너무 많이 읽는 것과 유일한 쓰기 작업인 refresh_stats뿐이며, 이것도 뷰어가 통계를 다시 세게 할 뿐입니다.
도구는 사람들이 실제로 대화 기록에서 무언가를 찾는 방식에 맞춰져 있습니다. 전체 대화 동시 검색, 사용자 시간대 기준 하루치 읽기, 검색 결과 앞뒤 메시지 가져오기로 특정 화요일에 프로젝트 그룹에서 무엇을 합의했는지 같은 질문에 답할 수 있습니다. 포럼 주제와 폴더를 지원하며, 사진은 1,568픽셀로 축소되어 돌아오므로 비전 모델이 누군가 올린 스크린숏을 읽을 수 있습니다.
네트워크 기본값은 대부분의 커뮤니티 서버보다 낫습니다. stdio에서는 아무것도 수신 대기하지 않습니다. Streamable HTTP 모드는 루프백에 바인딩하고 Origin 헤더를 확인하며 요청 크기를 제한하고, 다른 주소에서는 MCP_AUTH_TOKEN 없이 시작을 거부합니다. 릴리스 0.4.2는 지나치게 큰 요청으로 서버가 죽지 않도록 일부러 Go 1.27.4로 다시 빌드했습니다.
주의할 점: 이 서버의 쓸모는 뒤에 있는 보관소에 달려 있으며, 그것은 부담이 따르는 일입니다. Telegram Archive에는 Docker Compose, Telegram API ID와 해시, 사용자 계정 로그인이 필요하며, 편집 내역과 삭제된 메시지를 다른 사람의 것까지 보관합니다. MCP 클라이언트를 여기에 연결하면 삭제된 것을 포함해 그 메시지들이 클라이언트가 쓰는 모델 제공업체로 전송됩니다. 프로젝트 규모도 작습니다. MCP 서버 스타 13개, Telegram Archive 252개, 지난 한 달 npm 다운로드 약 2,100회이며, 사람이 한 커밋은 모두 한 명의 메인테이너가 했습니다.
결론: Telegram 기록을 홈 서버에 두기로 이미 마음먹었다면, 이것은 그 기록을 어시스턴트로 검색할 수 있게 하는 신중한 방법입니다. 관리자 로그인을 넘기지 말고 검색하게 할 대 화로 제한한 뷰어 계정을 만드십시오.
제 역할을 하는 곳
Telegram 그룹에서 고객과 작업 범위를 정하는 프리랜서 개발자
석 달 전 고객이 실제로 무엇을 승인했는지 찾기
어시스턴트에게 고객 그룹에서 기능 이름을 검색하게 한 뒤 주변 메시지와 그날의 대화를 읽게 합니다. 끝없이 스크롤하는 대신 몇 초면 되며, 비용은 보관소를 돌리는 서버뿐입니다.
회원 5,000명의 Telegram 포럼 그룹 운영자
일주일을 놓친 회원을 위해 활발한 주제를 요약
그룹의 포럼 주제를 나열하고 선택한 주제를 페이지 단위로 읽은 뒤 모델에게 요약을 작성하게 합니다. 에이전트가 개인 대화를 읽지 못하도록 그 그룹으로 제한한 뷰어 계정을 사용하십시오.
공개 Telegram 채널을 보관하는 연구자
어떤 주장이 여러 채널에서 처음 나타난 시점 추적
보관된 모든 대화에서 해당 문구를 검색하고 각 결과를 맥락과 함께 읽으며 날짜를 비교합니다. 보관소가 남긴 편집과 삭제 기록으로 게시 후 글이 바뀌었는지 알 수 있습니다.
도입 전 확인할 점
- 설정
- 먼저 Telegram Archive를 실행합니다(Docker Compose, Telegram api_id와 api_hash, 한 번의 로그인). 그다음 TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS와 함께 npx -y telegram-archive-mcp를 추가합니다. Claude Code, Claude Desktop, Cursor, VS Code, Codex용 설정이 문서화되어 있습니다.
- 연동
- stdio 또는 Streamable HTTP로 도구 12개와 리소스 4개를 제공하며, MCP 개정판 2024-11-05부터 2026-07-28까지 지원합니다. 체크섬으로 검증한 바이너리를 내려받는 npm 패키지, Docker 이미지, 여러 플랫폼용 Go 바이너리로 배포됩니다.
- 데이터와 개인정보
- 보관소는 사용자 디스크에 남지만, 도구가 반환하는 모든 메시지, 사진, 통계는 모델 제공업체로 전달됩니다. 뷰어 사용자 이름과 비밀번호는 클라이언트 환경에 저장됩니다. HTTP 모드는 루프백에 바인딩하고 Origin을 확인하며 다른 주소에서는 MCP_AUTH_TOKEN을 요구합니다.
- 대규모 사용 시 비용
- 무료입니다. 비용은 보관소 호스트와 저장 공간이며, 저장하기로 한 미디어에 따라 늘어납니다. Telegram Archive는 지정한 크기를 넘는 파일을 건너뛸 수 있습니다.
- 제한
- 읽기 접근만 가능하며 Telegram에서 아무것도 보내거나 편집하거나 삭제할 수 없습니다. 검색 품질은 Telegram Archive 자체 검색에 달려 있습니다. 보안 수정은 최신 릴리스만 받습니다.
좋은 점
- Telegram에 연결하지 않고 로컬 보관소를 읽음
- 통계 도구 하나를 빼면 읽기 전용이며 그것도 READ_ONLY=1로 숨김
- 하루 단위 읽기와 대화 전체 검색
- HTTP 모드는 토큰 없이 루프백 외 주소를 거부
아쉬운 점
- 실행 중인 Telegram Archive 인스턴스 필요
- 보관·삭제된 메시지가 모델 제공업체로 전달됨
- 메인테이너 한 명에 사용자층이 작음
- 뷰어 비밀번호가 클라이언트 설정에 들어감
추천 대상
이미 Telegram Archive를 자체 호스팅하고 있으며 어 시스턴트가 저장된 대화를 검색하고 요약하기를 원하는 사람.
Telegram Archive MCP 대안
Telegram Archive MCP: 자주 묻는 질문
- Telegram Archive MCP, 쓸 만한 가치가 있습니까?
- 자신의 Telegram 기록을 들여다보는 깔끔하고 거의 완전한 읽기 전용 창이지만, 이미 Telegram Archive를 운영하고 있고 대화가 모델 제공업체로 넘어가는 것을 받아들일 때만 가치가 있습니다. 평점은 5점 만점에 3.8점입니다.
- Telegram Archive MCP의 가격은 얼마입니까?
- 무료 오픈 소스(GPL-3.0-or-later)이며 Telegram Archive도 마찬가지입니다. 비용은 보관소를 호스팅하는 컴퓨터뿐입니다.
- Telegram Archive MCP의 단점은 무엇입니까?
- 실행 중인 Telegram Archive 인스턴스 필요; 보관·삭제된 메시지가 모델 제공업체로 전달됨; 메인테이너 한 명에 사용자층이 작음; 뷰어 비밀번호가 클라이언트 설정에 들어감.
- Telegram Archive MCP에 적합한 사람은 누구입니까?
- 이미 Telegram Archive를 자체 호스팅하고 있으며 어시스턴트가 저장된 대화를 검색하고 요약하기를 원하는 사람.
- 팀이나 프로덕션 환경에서 Telegram Archive MCP의 비용은 얼마입니까?
- 무료입니다. 비용은 보관소 호스트와 저장 공간이며, 저장하기로 한 미디어에 따라 늘어납니다. Telegram Archive는 지정한 크기를 넘는 파일을 건너뛸 수 있습니다.
- Telegram Archive MCP에 회사 데이터를 맡겨도 안전합니까?
- 보관소는 사용자 디스크에 남지만, 도구가 반환하는 모든 메시지, 사진, 통계는 모델 제공업체로 전달됩니 다. 뷰어 사용자 이름과 비밀번호는 클라이언트 환경에 저장됩니다. HTTP 모드는 루프백에 바인딩하고 Origin을 확인하며 다른 주소에서는 MCP_AUTH_TOKEN을 요구합니다.
- Telegram Archive MCP의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Slack MCP Server 및 Paperless-NGX MCP Server입니다.
답변 확인일: 2026년 11월 13일.