Tg MCP

🚀 MCP テレグラムサーバー

強力な機能を備えたテレグラムサーバーの実装です。クリーンなAPIインターフェースを通じて、メッセージの検索、送信、チャット管理などのテレグラム機能を提供します。

サポート、更新情報、コミュニティディスカッションに参加するには、テレグラムのディスカッショングループに参加してください。

✨ 主な機能

• 多モードのメッセージ検索:
  • 基本的なテキスト検索
  • カスタムフィルターを使用した高度な検索
  • 正規表現を使用したパターンベースの検索
• チャット管理:
  • 利用可能なチャットを一覧表示
  • オプションの返信機能付きでメッセージを送信
  • メッセージのリンクを生成
• 分析とデータ:
  • チャットの統計情報と分析
  • チャットデータのエクスポート機能
• 強力なエラー処理とロギング機能
• MCP（モデル制御プロトコル）アーキテクチャに基づいて構築

📦 インストール

前提条件

• Python 3.x
• テレグラムAPIの認証情報（API ID、API Hash）
• MCP互換環境（例: Cursor IDE）

インストール手順

1. リポジトリをクローンし、プロジェクトディレクトリに移動します。

git clone https://github.com/leshchenko1979/tg_mcp.git
cd tg_mcp

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

pip install -r requirements.txt

3. ルートディレクトリに.envファイルを作成し、テレグラムの認証情報を記載します。

API_ID=your_api_id
API_HASH=your_api_hash
PHONE_NUMBER=+123456789

4. セットアップスクリプトを実行して、テレグラムとの認証を行います。

python setup_telegram.py

これにより、テレグラムのセッションデータが格納されたセッションファイル（mcp_telegram_search.session）が作成されます。

📚 ドキュメント

Cursorの設定

このサーバーをCursor IDEと一緒に使用するには、以下の手順を実行します。

1. .cursorディレクトリにmcp.jsonファイルを作成し、以下の内容を記載します。

{
  "mcpServers": {
    "telegram_server": {
      "type": "local",
      "config": {
        "env_file": ".env"
      }
    }
  }
}

2. Cursorを起動し、新しいMCPサーバーに接続します。

使用方法

メッセージハッシュの計算

mcp TelegramServer \
    --hash "Hello, World!"

チャットログのバッチ処理

for message in $(seq 1 100); do
    mcp TelegramServer \
        --send "Message $message"
done

プロジェクト構造

プロジェクトディレクトリ/
├── setup_telegram.py         # テレグラムのセットアップスクリプト
├── requirements.txt          # プロジェクトの依存関係
├── .env                      # 環境変数（このファイルを作成）
├── logs/                    # ログファイルのディレクトリ
├── LICENSE                 # MITライセンス
└── src/
    ├── server.py            # メインサーバーのロジック
    └── utils.py           # 補助関数とツール

注意: 認証後に*.session と *.session-journal ファイルが生成されます

依存関係

このプロジェクトは以下の主要なパッケージに依存しています。

loguru          # ロギング
aiohttp         # 非同期HTTP
mcp[cli]        # モデル制御プロトコル
telethon>=1.34.0  # テレグラムクライアント
python-dotenv>=1.0.0  # 環境管理

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。