telegram-notify-mcp

Telegram Notify MCP

役割はひとつだけの、とてもシンプルなMCPサーバーです。AI エージェントの進捗を Telegram であなたに知らせます。

それだけです。チャット管理、グループ管理、インラインクエリはありません。テキスト、画像、ファイルで通知するだけです。

エージェントを起動してその場を離れると、完了時（または作業中）に Telegram メッセージが届きます。それ以上でも、それ以下でもありません。

クイックスタート

1. Telegram ボットを作成する

1. Telegram で @BotFather にメッセージを送ります
2. /newbot を送信し、表示される手順に従います
3. ボットのトークンをコピーします

2. ボットとのチャットを開始する

Telegram でボットを見つけて /start を送信します。ボットがチャット ID を検出するために必要です。

3. MCP クライアントに追加する

Claude Code

claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp

Claude Desktop / Cursor / Windsurf

MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@parthj/telegram-notify-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "TELEGRAM_USERNAME": "your-telegram-username"
      }
    }
  }
}

設定

環境変数	必須	説明
TELEGRAM_BOT_TOKEN	はい	@BotFather から取得したボットのトークン
TELEGRAM_USERNAME	はい	あなたの Telegram ユーザー名（@なし）

ツール

ツールは3つだけです。これがすべてです。

send_message

ユーザーにテキストで進捗を送信します。

パラメーター	型	必須	説明
text	string	はい	メッセージのテキスト
parse_mode	string	いいえ	HTML、Markdown、または MarkdownV2

send_photo

スクリーンショット、グラフ、生成したビジュアルなどの画像を送信します。

パラメーター	型	必須	説明
photo	string	はい	URL または絶対ファイルパス
caption	string	いいえ	写真のキャプション
parse_mode	string	いいえ	キャプションの書式モード

send_document

レポート、ログ、ビルド成果物などのファイルを送信します。

パラメーター	型	必須	説明
document	string	はい	URL または絶対ファイルパス
caption	string	いいえ	ドキュメントのキャプション
parse_mode	string	いいえ	キャプションの書式モード

仕組み

• 最初のツール呼び出し時に、サーバーは Telegram Bot API の getUpdates を使ってユーザー名をチャット ID に解決します
• ボットへの /start の送信が必要です。Telegram ボットは、会話を開始したユーザーにしかメッセージを送信できません
• チャット ID はプロセスの実行中キャッシュされます

開発

git clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run build

ライセンス

MIT