Telegram MCP Server Ff8

🚀 Telegram MCP サーバー

Telegramを統合した強力なサーバーです。このサーバーは、連絡先の管理、メッセージの送信、MCP（マルチクライアントプロトコル）を通じたチャンネル情報の取得など、様々なツールを提供します。

✨ 主な機能

連絡先管理

• 連絡先リストの取得
• 連絡先の検索
• 最近のやり取りの確認

メッセージ機能

• 名前または電話番号で連絡先にメッセージを送信
• 日付範囲でチャット履歴をフィルタリング
• 最近のやり取りの確認

チャンネル機能

• チャンネルの投稿を取得
• チャンネルの検索
• チャンネル情報の確認
• 日付範囲で投稿を絞り込む

📦 インストール

前提条件

• Python 3.8 以上
• Node.js 14 以上（npx インストール用）
• Telegram API の認証情報（api_id と api_hash）
• Telegram アカウント

インストール手順

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

git clone https://github.com/yourusername/telegram-MCP-server.git
cd telegram-MCP-server

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

uv venv .venv  # 仮想環境の作成
source .venv/bin/activate  # アクティベート（Linux/macOS）
.\venv\Scripts\activate  # アクティベート（Windows）
uv pip install

3. プロジェクトのルートディレクトリに .env ファイルを作成し、Telegram の認証情報を入力します。

TG_API_ID=your_api_id
TG_API_HASH=your_api_hash
phone=your_phone_number  # 形式：+1234567890

💻 使用例

Cursor/Claude Desktop との統合

以下の JSON をコピーし、{{PATH}} の値を置き換えます。

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}", // `which uv` を実行し、出力をここに配置
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // リポジトリ内で `pwd` を実行し、出力結果を入力して "/whatsapp-mcp-server" を追加
        "run",
        "main.py"
      ]
    }
  }
}

Claude の場合は、このファイルを以下の場所に claude_desktop_config.json として保存します。

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor の場合は、このファイルを以下の場所に mcp.json として保存します。

~/.cursor/mcp.json

📚 ドキュメント

ツールのAPIドキュメント

get_contacts()

すべてのTelegram連絡先のリストを返します。連絡先の名前、電話番号、ユーザー名が含まれます。

send_message_by_identifier(identifier: str, message: str)

名前または電話番号で特定の連絡先にメッセージを送信します。

• identifier: 連絡先の名前または電話番号
• message: 送信するテキストメッセージ

get_last_interaction(identifier: str)

特定の連絡先との最近のメッセージを返します。

• identifier: 連絡先の名前または電話番号

get_chat_history(identifier: str, start_date: str = None, end_date: str = None, limit: int = 20)

指定された日付範囲内の特定の連絡先とのチャット履歴を取得します。

• identifier: 連絡先の名前または電話番号
• start_date: オプションの開始日（YYYY-MM-DD）
• end_date: オプションの終了日（YYYY-MM-DD）
• limit: オプションの結果数制限

get_posts_by_hashtag(hashtag: str, limit: int = 20)

指定されたハッシュタグで投稿を検索します。

• hashtag: 検索するハッシュタグ
• limit: オプションの結果数制限

エラーハンドリング

handle_errors()

発生する可能性のあるエラーを処理します。

🔧 技術詳細

セキュリティに関する考慮事項

• 認証情報の安全性を確保し、漏洩を防ぎます。
• 公共のネットワークでこのツールを使用しないでください。

🤝 貢献ガイド

貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

貢献者

• [あなたの名前] - [あなたの役割]

📄 ライセンス

[ライセンス内容を挿入]