Telegram MCP Server Oor

🚀 Telegram MCP サーバー

MCPプロトコルを実装したサーバーで、Telegram Bot API とのインタラクションツールを提供します。このサービスにより、AIアシスタントはメッセージを送信し、ボット情報を取得できます。

🚀 クイックスタート

このサーバーはMCPプロトコルを実装し、Telegram Bot APIとのやり取りを可能にします。以下の手順でサーバーを起動し、各種ツールを利用できます。

✨ 主な機能

このサーバーは、MCPプロトコルを実装し、Telegram Bot APIとのインタラクションを可能にするツールを提供します。以下に、提供される主なツールを紹介します。

💻 使用例

ツールの使用方法

get_bot_info

ボットの基本情報を取得します。

• パラメータは不要です。
• ボット情報を含む User オブジェクトを返します。

send_message

指定されたチャットにメッセージを送信します。

• chatId：宛先チャットの一意の識別子（文字列または数字）
• text：送信するメッセージのテキスト
• params（オプション）：追加のメッセージパラメータ（例：parse_mode、reply_markup など）

get_updates

長時間ポーリングを使用して、着信更新を受信します。

• params（オプション）：オプションパラメータを含むオブジェクト：
  • offset（オプション）：返す最初の更新の識別子
  • limit（オプション）：取得する更新の数を制限（1 - 100）
  • timeout（オプション）：長時間ポーリングのタイムアウト時間（秒）
  • allowed_updates（オプション）：受信する更新タイプの配列
• 様々な更新タイプを含む Update オブジェクトの配列を返します：
  • メッセージと編集後のメッセージ
  • チャンネル投稿
  • ビジネス情報
  • アクションクエリ
  • コールバッククエリ
  • 商品クエリ
  • 事前チェッククエリ
  • 投票とその回答
  • チャットメンバーの更新
  • チャット参加リクエスト
  • チャットの昇格

forward_message

あらゆるタイプのメッセージを転送します。サービスメッセージや保護されたコンテンツを含むメッセージは転送できません。

• chatId：宛先チャットの一意の識別子またはチャンネルのユーザー名（@channelusername 形式）
• fromChatId：元のメッセージが送信されたチャットの一意の識別子（またはチャンネルのユーザー名、@channelusername 形式）
• messageId：from_chat_id で指定されたチャット内のメッセージの識別子
• params（オプション）：オプションパラメータを含むオブジェクト：
  • message_thread_id（オプション）：宛先メッセージスレッド（トピック）の一意の識別子（フォーラムスーパーグループのみ）
  • video_start_timestamp（オプション）：転送するビデオの新しい開始タイムスタンプ
  • disable_notification（オプション）：メッセージをサイレントで送信します。ユーザーは音なしで通知を受け取ります。
  • protect_content（オプション）：転送されたメッセージのコンテンツを保護し、転送や保存を防止します。
• 成功すると、送信された Message オブジェクトを返します。

📦 インストール

環境変数の設定

以下の環境変数を設定する必要があります。

TELEGRAM_BOT_TOKEN=your_bot_token

あなたは @BotFather ボットとTelegram上で会話し、新しいボットを作成することで、あなたのボットトークンを取得できます。

新しいボットの作成

/newbot コマンドを使用して、新しいボットを作成します。@BotFather は名前とユーザー名を要求し、ボットを認証するための認証トークンを生成します。

ボットの名前は、連絡先詳細や他の場所に表示されます。

ユーザー名は短い名前で、検索、メンション、t.me リンクに使用されます。ユーザー名は5 - 32文字で、大文字と小文字を区別せず、ラテン文字、数字、アンダースコアのみを含むことができます。あなたのボットは、Telegramチャンネルを持っていない限り、@username で直接メッセージを受信できません。

完了すると、@BotFather は新しいTelegram Bot APIトークンをあなたのプライベートチャットに送信します。

開発手順

1. 依存関係をインストールします。

npm install

2. サーバーを起動します。

node index.js

3. http://localhost:8090 にアクセスしてテストします。

📄 ライセンス

MIT License

このドキュメントは NexusX-MCP/telegram-mcp-server プロジェクトの公式ガイドです。