Telegram MCP Server
Telegram 메시지 발송을 위한 Model Context Protocol (MCP) 서버입니다.
기능
- send_message: Telegram 채팅방으로 메시지 전송
- 최대 4096자까지 지원
- HTML, Markdown, MarkdownV2 형식 지원
설치
1. 의존성 설치
pnpm install2. 환경 변수 설정
.env.example을 복사하여 .env를 생성하고 다음 값을 입력하세요:
cp .env.example .env필수 환경 변수
TELEGRAM_BOT_TOKEN: @BotFather에서 생성한 봇 토큰TELEGRAM_CHAT_ID: 메시지를 받을 채팅 ID
3. 빌드
pnpm build사용법
Claude에 MCP 서버 등록
클라우드에서 이 MCP 서버를 사용하려면, .claude/mcp.json 파일에서 다음과 같이 설정해야 합니다:
{
"mcpServers": {
"telegram": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_bot_token",
"TELEGRAM_CHAT_ID": "your_chat_id"
}
}
}
}도구 사용
send_message
메시지를 Telegram으로 전송합니다.
파라미터:
message(필수): 전송할 메시지 내용 (최대 4096자)parse_mode(선택):HTML,Markdown, 또는MarkdownV2
예시:
메시지 "Hello World"를 telegram으로 전송해줘마크다운 형식 사용:
다음 메시지를 HTML 형식으로 telegram에 보내줘:
<b>굵은 텍스트</b>
<i>기울임 텍스트</i>Telegram 봇 설정
1. BotFather에서 봇 생성
- Telegram에서 @BotFather를 검색
/start명령으로 시작/newbot명령으로 새 봇 생성- 봇 이름과 username 설정
- 생성된 토큰 복사
2. Chat ID 확인
다음 방법 중 하나로 Chat ID를 확인할 수 있습니다:
방법 1: getMe API 사용 ``bash curl https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe ``
방법 2: 메시지 전송 후 업데이트 확인 ``bash curl https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates ``
문제 해결
"TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables are required"
환경 변수가 올바르게 설정되었는지 확인하세요.
Telegram API 에러
- 401 Unauthorized: 봇 토큰이 잘못되었을 수 있습니다.
- 400 Bad Request: Chat ID가 잘못되었거나 봇이 해당 채팅방에 접근 권한이 없을 수 있습니다.
개발
개발 모드 실행
pnpm dev빌드
pnpm build라이선스
MIT
