sparfenyuk/mcp-telegram
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
sparfenyuk/mcp-telegram은 [[T0]에서 가져온 MCP 서버 후보입니다.
개요
sparfenyuk/mcp-telegram은 [[T0]에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
- 텔레그램 MCP 서버
- 소개
- MCP가 뭐야?
- 이 서버는 뭐 하는 거야?
- 실용적인 사용 사례
- 선수 조건
- 설치
- 구성
- 텔레그램 API 구성
- 클로드 데스크톱 구성
- 텔레그램 구성
- 개발
- 시작
- 터미널에서 서버 디버깅
- 인스펙터에서 서버 디버깅
- 문제 해결
- 메시지 ‘MCP 서버에 연결할 수 없음’ mcp-telegram
소개
서버는 텔레그램 API와 AI 어시스턴트 사이의 다리 역할을 하며, 모델 컨텍스트 프로토콜(Model Context Protocol)을 기반으로 합니다.
[! 중요] 이 서버를 사용하기 전에 Telegram API 이용 약관을 읽고 이해했는지 확인하세요. 텔레그램 API를 악용할 경우 계정 정지가 발생할 수 있습니다.
MCP란 무엇인가?
모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 앱이 외부 도구와 데이터 소스에 연결할 수 있게 해주는 시스템입니다. 이 프로토콜은 AI 어시스턴트가 로컬 서비스와 API를 다루면서 사용자가 직접 제어할 수 있도록 명확하고 안전하게 작동할 수 있도록 합니다.
이 서버는 무엇을 하는 걸까요?
현재로서는 서버가 텔레그램 API에 대한 읽기 전용 접근을 제공합니다.
- [x] 대화 목록(채팅, 채널, 그룹) 받아보세요
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Telegram MCP server
- Telegram MCP server
About
The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.
[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.
What is MCP?
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
What does this server do?
As of not, the server provides read-only access to the Telegram API.
- [x] Get the list of dialogs (chats, channels, groups)
- [x] Get the list of (unread) messages in the given dialog
- [ ] Mark chanel as read
- [ ] Retrieve messages by date and time
- [ ] Download media files
- [ ] Get the list of contacts
- [ ] Draft a message
- …
Practical use cases
- [x] Create a summary of the unread messages
- [ ] Find contacts with upcoming birthdays and schedule a greeting
- [ ] Find discussions on a given topic, summarize them and provide a list of links
Prerequisites
Installation
uv tool install git+https://github.com/sparfenyuk/mcp-telegram
[!NOTE] If you have already installed the server, you can update it using
uv tool upgrade --reinstallcommand.
[!NOTE] If you want to delete the server, use the
uv tool uninstall mcp-telegramcommand.
Configuration
Telegram API Configuration
Before you can use the server, you need to connect to the Telegram API.
-
Get the API ID and hash from Telegram API
-
Run the following command:
설치
npx @modelcontextprotocol/inspector uv run mcp-telegram설정
{
"mcpServers": {
"mcp-telegram": {
"command": "mcp-server",
"env": {
"TELEGRAM_API_ID": "<your-api-id>",
"TELEGRAM_API_HASH": "<your-api-hash>",
},
}
}
}
}