MCP Telegram Poc

🚀 MCP と Telegram の統合サンプル

Python をベースとしたモデルコンテキストプロトコル（MCP）のクライアントとサーバーで、LLM が Telegram を通じて通知を送信し、ユーザーの返信を受け取ることができます。

✨ 主な機能

• カスタマイズ可能な優先度レベル付きのテキストアラートを Telegram チャットに送信する
• ユーザーの返信を確認し、タイムアウト時間を設定する
• MCP 互換の LLM アプリケーションとの統合をサポートする柔軟なテンプレート

📚 詳細ドキュメント

MCP と関数呼び出しまたはエージェントツールの比較

MCP プロトコル（モデルコンテキストプロトコル）：

• LLM の推論（「コンテキスト」）と外部操作の実行を分離します。例えば、LLM が何のアクションを取るかを決定し、MCP サーバーがその操作を実行する方法を処理します。
• この分離により、コアの LLM モデルやそのプロンプトを変更することなく、外部ツールを更新または交換できます。
• 操作をより安全で制御された方法で実行することも可能になります。

LLM 関数呼び出しまたはエージェント：

• 直接の関数呼び出しまたはエージェントベースの方法は、通常、意思決定と実行ロジックを混在させるため、システムのモジュール性が低くなる可能性があります。
• 操作の実行方法を変更するには、エージェントを再構築したり、LLM のプロンプトを変更したりする必要があり、保守が困難になります。

📦 インストール

前提条件

• Python 3.11 以上のバージョン
• Telegram ボットトークン（@BotFather から取得）
• あなたの Telegram チャット ID

インストール手順

1. リポジトリをクローンします：

   git git@github.com:arananet/mcp-telegram-poc.git
   cd mcp-telegram-poc
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. 仮想環境を作成します：

   python3 -m venv .venv
   

4. .env.example を .env にコピーし、あなたの Telegram 認証情報を入力します：

   cp .env.example .env
   nano .env
   

設定

.env ファイルを編集し、以下の内容を入力します：

• TELEGRAM_BOT_TOKEN= あなたのボットトークン
• TELEGRAM_CHAT_ID= あなたのチャット ID
• OPENAI_API_KEY= あなたの OpenAI API キー

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

1. Telegram で @BotFather とチャットします。
2. /newbot を送信し、名前（例：mcp_example）とユーザー名（例：mcp_example_bot）を提供します。このとき、BotFather からトークンが返信されます。
3. 提供されたトークンをコピーします。

あなたのチャット ID の取得方法

1. あなたのボットにメッセージを送信します（作成したボットのページに移動し、「hi」などのサンプルメッセージを送信します）。
2. https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates にアクセスします。
3. chat オブジェクトの id フィールドを探します。例えば、"chat":{"id": "<あなたのチャット ID>", ...} のような内容が表示されます。<あなたのチャット ID> を抽出します。

💻 使用例

基本的な使用法

サーバーの起動

python3 -m mcp_server

アラートの送信

python3 -c "from mcp_client import send_alert; send_alert('これはテストアラートです！')"

高度な使用法

send_alert 関数

Telegram チャットにアラートを送信します。

パラメータ

• message (str): 送信するメッセージ。

サンプルコード

from mcp_client import send_alert

send_alert("システムで異常が検出されました。注意してください！")

check_reply 関数

ユーザーのメッセージに対する返信を確認します。

パラメータ

• message_id (int): メッセージの ID。
• timeout (int, オプション): 返信を待つ時間（秒単位）。デフォルト値：30。

戻り値

• str: ユーザーの返信またはタイムアウト後の空文字列。

🔧 開発情報

• プロジェクトドキュメント: MCP と Telegram の統合
• 問題の報告: GitHub Issues でエラーや提案を提出してください。
• ライセンス: このプロジェクトは MIT ライセンスの下で提供されています。