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
使用例
使用例
基本的な使用方法
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内の特定のチャットを検索し、関連情報を提供するツールの開発