telegram-bot-mcp-vercel

MyeongJungKwon/telegram-bot-mcp-vercel

3.2

If you are the rightful owner of telegram-bot-mcp-vercel and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is a specialized server designed to handle model context operations, providing a structured way to manage and interact with various model-based applications.

Tools
  1. generate-endpoint

    API endpoint generation tool.

  2. analyze-api

    Tool for analyzing API structures and operations.

  3. analyze-telegram-message

    Tool for analyzing Telegram messages.

Telegram Bot + MCP Server on Vercel

Vercel에 배포 κ°€λŠ₯ν•œ TypeScript 기반 Telegram Botκ³Ό MCP (Model Context Protocol) Server 톡합 ν”„λ‘œμ νŠΈμž…λ‹ˆλ‹€.

πŸš€ νŠΉμ§•

  • TypeScript 100%: μ™„μ „ν•œ νƒ€μž… μ•ˆμ •μ„±
  • Vercel μ΅œμ ν™”: μ„œλ²„λ¦¬μŠ€ ν™˜κ²½μ— νŠΉν™”
  • MCP 톡합: Model Context Protocol μ„œλ²„ λ‚΄μž₯
  • Telegraf ν”„λ ˆμž„μ›Œν¬: κ°•λ ₯ν•œ Telegram Bot κΈ°λŠ₯
  • μ¦‰μ‹œ 배포: ν™˜κ²½λ³€μˆ˜ μ„€μ •λ§ŒμœΌλ‘œ 배포 μ™„λ£Œ

πŸ“‹ 사전 μš”κ΅¬μ‚¬ν•­

  • Node.js 18.0.0 이상
  • Telegram Bot Token
  • Vercel 계정

πŸ› οΈ μ„€μΉ˜ 및 μ„€μ •

1. ν”„λ‘œμ νŠΈ 클둠

git clone <your-repo-url>
cd telegram-bot-mcp-vercel

2. μ˜μ‘΄μ„± μ„€μΉ˜

npm install
# λ˜λŠ”
yarn install

3. ν™˜κ²½λ³€μˆ˜ μ„€μ •

cp .env.example .env

.env νŒŒμΌμ„ νŽΈμ§‘ν•˜μ—¬ λ‹€μŒ 값듀을 μ„€μ •ν•˜μ„Έμš”:

BOT_TOKEN=your_telegram_bot_token_here
WEBHOOK_URL=https://your-vercel-app.vercel.app/webhook

4. 둜컬 개발

npm run dev

πŸš€ Vercel 배포

1. Vercel CLI μ‚¬μš©

# Vercel CLI μ„€μΉ˜ (처음만)
npm i -g vercel

# 배포
vercel

2. GitHub 연동 배포

  1. GitHub에 ν”„λ‘œμ νŠΈ ν‘Έμ‹œ
  2. Vercel Dashboardμ—μ„œ Import
  3. ν™˜κ²½λ³€μˆ˜ μ„€μ •:
    • BOT_TOKEN: Telegram Bot Token
    • WEBHOOK_URL: 배포된 URL + /webhook

3. μ›Ήν›… μ„€μ •

배포 μ™„λ£Œ ν›„ Telegram에 웹훅을 등둝해야 ν•©λ‹ˆλ‹€:

curl -X POST "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook" \
     -H "Content-Type: application/json" \
     -d '{"url": "https://your-vercel-app.vercel.app/webhook"}'

πŸ€– Bot λͺ…λ Ήμ–΄

  • /start - 봇 μ‹œμž‘ 및 ν™˜μ˜ λ©”μ‹œμ§€
  • /help - 도움말 보기
  • /mcp - MCP μ„œλ²„ μƒνƒœ 확인
  • /ping - μ„œλ²„ 응닡 ν…ŒμŠ€νŠΈ
  • /echo [λ©”μ‹œμ§€] - λ©”μ‹œμ§€ λ”°λΌν•˜κΈ°

πŸ”§ MCP μ„œλ²„ κΈ°λŠ₯

μ—”λ“œν¬μΈνŠΈ

  • GET /mcp - MCP μ„œλ²„ μƒνƒœ 및 정보
  • POST /mcp - MCP μš”μ²­ 처리

제곡 도ꡬ

  1. generate-endpoint: API μ—”λ“œν¬μΈνŠΈ 생성
  2. analyze-api: API 뢄석
  3. analyze-telegram-message: ν…”λ ˆκ·Έλž¨ λ©”μ‹œμ§€ 뢄석

제곡 λ¦¬μ†ŒμŠ€

  • api-spec: Telegram Bot API λͺ…μ„Έμ„œ

πŸ“ ν”„λ‘œμ νŠΈ ꡬ쑰

telegram-bot-mcp-vercel/
β”œβ”€β”€ api/
β”‚   β”œβ”€β”€ webhook.ts      # Telegram Bot μ›Ήν›… ν•Έλ“€λŸ¬
β”‚   └── mcp.ts          # MCP μ„œλ²„ κ΅¬ν˜„
β”œβ”€β”€ package.json        # ν”„λ‘œμ νŠΈ μ„€μ •
β”œβ”€β”€ tsconfig.json       # TypeScript μ„€μ •
β”œβ”€β”€ vercel.json         # Vercel 배포 μ„€μ •
β”œβ”€β”€ .env.example        # ν™˜κ²½λ³€μˆ˜ μ˜ˆμ‹œ
└── README.md           # ν”„λ‘œμ νŠΈ λ¬Έμ„œ

πŸ” API ν…ŒμŠ€νŠΈ

Telegram Bot ν…ŒμŠ€νŠΈ

봇과 λŒ€ν™”ν•˜μ—¬ κΈ°λŠ₯을 ν…ŒμŠ€νŠΈν•  수 μžˆμŠ΅λ‹ˆλ‹€.

MCP μ„œλ²„ ν…ŒμŠ€νŠΈ

# μ„œλ²„ μƒνƒœ 확인
curl https://your-vercel-app.vercel.app/mcp

# 도ꡬ λͺ©λ‘ 쑰회
curl -X POST https://your-vercel-app.vercel.app/mcp \
     -H "Content-Type: application/json" \
     -d '{"method": "tools/list"}'

πŸ›‘οΈ λ³΄μ•ˆ 고렀사항

  • BOT_TOKEN은 μ ˆλŒ€ μ½”λ“œμ— ν•˜λ“œμ½”λ”©ν•˜μ§€ λ§ˆμ„Έμš”
  • Vercel ν™˜κ²½λ³€μˆ˜λ₯Ό ν†΅ν•΄μ„œλ§Œ λ―Όκ°ν•œ 정보λ₯Ό κ΄€λ¦¬ν•˜μ„Έμš”
  • ν”„λ‘œλ•μ…˜μ—μ„œλŠ” μ›Ήν›… URL 검증을 μΆ”κ°€ν•˜μ„Έμš”

πŸ“š μ°Έκ³  자료

🀝 κΈ°μ—¬ν•˜κΈ°

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ λΌμ΄μ„ μŠ€

이 ν”„λ‘œμ νŠΈλŠ” MIT λΌμ΄μ„ μŠ€ ν•˜μ— λ°°ν¬λ©λ‹ˆλ‹€.

❓ 문제 ν•΄κ²°

일반적인 λ¬Έμ œλ“€

1. Bot이 μ‘λ‹΅ν•˜μ§€ μ•ŠλŠ” 경우

  • BOT_TOKEN이 μ˜¬λ°”λ₯΄κ²Œ μ„€μ •λ˜μ—ˆλŠ”μ§€ 확인
  • 웹훅이 μ˜¬λ°”λ₯΄κ²Œ λ“±λ‘λ˜μ—ˆλŠ”μ§€ 확인
  • Vercel ν•¨μˆ˜ 둜그 확인

2. MCP μ„œλ²„ 였λ₯˜

  • MCP SDK 버전 ν˜Έν™˜μ„± 확인
  • TypeScript 컴파일 였λ₯˜ 확인

3. 배포 μ‹€νŒ¨

  • Node.js 버전 확인 (18.0.0 이상)
  • ν™˜κ²½λ³€μˆ˜ μ„€μ • 확인

더 μžμ„Έν•œ 도움이 ν•„μš”ν•˜λ©΄ Issuesλ₯Ό μƒμ„±ν•΄μ£Όμ„Έμš”!