Telegram MCP Server 65w

🚀 Telegram MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して、大規模言語モデルが Telegram を通じて通知を送信し、ユーザーからの応答を受け取ることを可能にします。

✨ 主な機能

• カスタマイズ可能な緊急度を持つテキスト通知を Telegram チャットに送信する
• ユーザーの応答を待機し、取得する
• Cline やその他の MCP 互換の LLM アプリケーションと統合する

📦 インストール

npm を使用する場合（推奨）

npm install -g telegram-mcp

GitHub からインストールする場合

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

📚 ドキュメント

前提条件

• Node.js 16 以上
• Telegram ボットトークン（@BotFather から取得）
• Telegram チャット ID

設定

サーバーには以下の 2 つの環境変数が必要です。

• TELEGRAM_BOT_TOKEN：Telegram ボットトークン
• TELEGRAM_CHAT_ID：Telegram チャット ID

Telegram ボットトークンの取得方法

1. Telegram で @BotFather と会話を開始する
2. /newbot コマンドを送信する
3. 指示に従って新しいボットを作成する
4. BotFather から新しいボットトークンを取得する

チャット ID の検索方法

1. 新しいボットと会話を開始する
2. ボットにメッセージを送信する
3. https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates にアクセスする
4. レスポンス内の chat オブジェクトを見つけ、id フィールドを記録する

使用方法

単独で実行する場合

# 環境変数を設定する
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHAT_ID="your_chat_id"

# サーバーを起動する
telegram-mcp

Cline と統合する場合

Cline MCP 設定ファイルに以下を追加します。

{
    "botToken": "your_bot_token",
    "chatId": "your_chat_id"
}

次に、以下のコマンドを実行します。

clarity run mcp-telegram-config.js

Clarice Desktop と統合する場合

Clarice Desktop 設定ファイルに以下を追加します。

{
    "botToken": "your_bot_token",
    "chatId": "your_chat_id"
}

次に、以下のコマンドを実行します。

claride run mcp-telegram-config.js

利用可能なツール

通知を送信する

以下のコマンドを使用して通知を送信します。

curl -X POST http://localhost:1234/send-notification \
  -H "Content-Type: application/json" \
  -d '{"message": "示例消息"}'

通知の状態を確認する

以下のコマンドを使用して通知の状態を確認します。

curl -X GET http://localhost:1234/check-notifications

開発ガイド

リポジトリをクローンする

git clone https://github.com/CHarrisTech/telegram-mcp.git
cd telegram-mcp

依存関係をインストールする

npm install

プロジェクトをビルドする

npm run build

テストスクリプトの例

Linux/MacOS

test.sh ファイルを作成します。

#!/bin/bash
set -e

# 変数を設定する
BOT_TOKEN="your_bot_token"
CHAT_ID="your_chat_id"

# 通知を送信する
curl -X POST http://localhost:1234/send-notification \
  -H "Content-Type: application/json" \
  -d '{"message": "测试消息"}'

# 通知の状態を確認する
curl -X GET http://localhost:1234/check-notifications

次に、以下のコマンドを実行します。

chmod +x test.sh
./test.sh

Windows

test.bat ファイルを作成します。

@echo off
set BOT_TOKEN=your_bot_token
set CHAT_ID=your_chat_id

curl -X POST http://localhost:1234/send-notification ^
  -H "Content-Type: application/json" ^
  -d '{"message": "测试消息"}'

curl -X GET http://localhost:1234/check-notifications

次に、以下のコマンドを実行します。

test.bat

サンプルコード

example.js ファイルを作成します。

const TelegramMCP = require('telegram-mcp');

// サーバーを初期化する
const server = new TelegramMCP({
    botToken: 'your_bot_token',
    chatId: 'your_chat_id'
});

// メッセージを送信する
server.sendNotification("这是一个测试消息。");

次に、以下のコマンドを実行します。

node example.js

📄 ライセンス

MIT