Telegram MCP Server

Telegram 메시지 발송을 위한 Model Context Protocol (MCP) 서버입니다.

기능

• send_message: Telegram 채팅방으로 메시지 전송
  • 최대 4096자까지 지원
  • HTML, Markdown, MarkdownV2 형식 지원

설치

1. 의존성 설치

pnpm install

2. 환경 변수 설정

.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에서 봇 생성

1. Telegram에서 @BotFather를 검색
2. /start 명령으로 시작
3. /newbot 명령으로 새 봇 생성
4. 봇 이름과 username 설정
5. 생성된 토큰 복사

2. Chat ID 확인

다음 방법 중 하나로 Chat ID를 확인할 수 있습니다:

방법 1: getMe API 사용

curl https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe

방법 2: 메시지 전송 후 업데이트 확인

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