mcp-telegram

mcp-telegramは、Large Language Models(LLMs)をTelegramと接続するためのPythonライブラリです。Model Context Protocol(MCP)を使用して、AIエージェントがTelegram上でメッセージの送信、編集、削除、チャットの検索、ドラフトの管理、メディアのダウンロードなどを行うことを可能にします。Telethonを基盤にしており、MTProtoを利用しています。

GitHubスター

127

ユーザー評価

未評価

お気に入り

0

閲覧数

40

フォーク

14

イシュー

6

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Python 3.10 or higher
uv (install via official guide)

インストール方法

インストール方法

前提条件

Python: 3.10以上
uv: [公式ガイド](https://github.com/astral-sh/uv#installation)に従ってインストール。

インストール手順

CLIツールをインストールします:
bash
uv tool install mcp-telegram

設定方法

設定方法

基本設定

認証情報の設定

最初にTelegramアカウントで認証します:
bash
mcp-telegram login
このコマンドは、API IDとAPI Hash、電話番号、認証コード、2FAパスワードを求めます。これらの情報はセッションファイルに安全に保存されます。 > 警告: API認証情報は秘密にして、公開しないでください。

使用例

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します:

コマンドラインでの使用

bash
mcp-telegram --help # すべてのコマンドを表示

プログラムでの使用

python
import requests

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

使用例

result = call_mcp_tool('analyze', { 'input': 'sample data', 'options': {'format': 'json'} })

使用ケース

AIエージェントがTelegramを通じて自動応答を行うシステムの構築
ユーザーからのメッセージを分析し、適切な返信を生成するチャットボットの開発
メディアファイルをTelegramからダウンロードして処理するアプリケーションの作成
Telegram内の特定のチャットを検索し、関連情報を提供するツールの開発
作者情報

15

フォロワー

5

リポジトリ

0

Gist

0

貢献数