Telegram

Telegram MCP 서버는 Telethon 통합을 통해 Telegram 메시징 플랫폼과 상호작용할 수 있는 MCP(Model Context Protocol) 서버입니다. 이 서버를 사용하면 인공지능 어시스턴트가 Telegram 채팅, 메시지, 연락처 등을 읽고 관리할 수 있습니다.

특징

• 채팅 목록 관리: 모든 대화, 채널, 그룹 목록 조회
• 메시지 조회: 지정된 대화에서 (읽지 않은) 메시지 목록 조회
• 채널 읽음 표시: 채널을 읽음으로 표시
• 날짜별 메시지 검색: 날짜 및 시간으로 메시지 검색
• 미디어 파일 다운로드: 채팅에서 미디어 파일 다운로드
• 연락처 관리: 연락처 목록 조회
• 메시지 초안 작성: 메시지 초안 작성 및 관리

API

도구

ListDialogs

모든 대화(채팅, 채널, 그룹)의 목록을 가져옵니다. - 입력: - unread: (선택 사항) 읽지 않은 메시지가 있는 대화만 표시할지 여부 - 출력: 대화 목록

GetMessages

지정된 대화에서 메시지 목록을 가져옵니다. - 입력: - dialog_id: 대화 ID - limit: (선택 사항) 가져올 메시지 수 - unread_only: (선택 사항) 읽지 않은 메시지만 가져올지 여부 - 출력: 메시지 목록

MarkAsRead

대화나 채널을 읽음으로 표시합니다. - 입력: - dialog_id: 대화 ID - 출력: 작업 상태

GetMessagesByDate

날짜 및 시간으로 메시지를 검색합니다. - 입력: - dialog_id: 대화 ID - date: 검색할 날짜 - time_from: (선택 사항) 시작 시간 - time_to: (선택 사항) 종료 시간 - 출력: 메시지 목록

DownloadMedia

메시지에 포함된 미디어 파일을 다운로드합니다. - 입력: - message_id: 메시지 ID - output_path: (선택 사항) 출력 경로 - 출력: 다운로드 상태 및 파일 경로

GetContacts

연락처 목록을 가져옵니다. - 입력: 없음 - 출력: 연락처 목록

DraftMessage

메시지 초안을 작성합니다. - 입력: - dialog_id: 대화 ID - text: 메시지 내용 - 출력: 작업 상태

사용 방법

설치

uv tool install git+https://github.com/sparfenyuk/mcp-telegram

Telegram API 설정

이 서버를 사용하기 위해서는 Telegram API 설정이 필요합니다:

1. Telegram API에서 API ID와 해시 획득 (https://my.telegram.org/apps)
2. 다음 명령으로 로그인:

   mcp-telegram sign-in --api-id <your-api-id> --api-hash <your-api-hash> --phone-number <your-phone-number>

3. Telegram에서 받은 코드를 입력하여 API 연결
4. 2단계 인증이 활성화된 경우 비밀번호 입력 필요

Claude Desktop 구성

Claude Desktop 구성 파일에 서버를 추가하는 예시:

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "mcp-server",
      "env": {
        "TELEGRAM_API_ID": "<your-api-id>",
        "TELEGRAM_API_HASH": "<your-api-hash>"
      }
    }
  }
}

보안 고려 사항

• Telegram API 서비스 약관을 읽고 이해해야 합니다.
• API ID와 해시는 비밀로 유지하고 어디에도 게시하지 마세요.
• Telegram 계정의 오용은 계정 정지로 이어질 수 있습니다.

제한 사항

• 현재는 읽기 전용 액세스만 제공되며, 메시지 전송 기능은 지원되지 않습니다.
• API 사용량 제한이 있을 수 있으며, 많은 요청은 계정 제한을 초래할 수 있습니다.

연결된 구성 요소

• Discord
• Slack
• Gmail