Telegram

🚀 Telegram MCP サーバー

英語版 | ロシア語版

このサーバーは、Model Context Protocol (MCP) を通じて Telegram API とやり取りするためのものです。AIエージェントやその他の MCP クライアントが Telegram とやり取りできるようにします。

✨ 主な機能

• AIエージェントや MCP クライアントが Telegram とやり取りできるようにする。
• 複数の MCP ツールをサポートし、Telegram とのやり取りを容易にする。

📦 インストール

必要条件

• Node.js 14+（またはそれ以上のバージョン）
• npm
• Telegram の API ID と API ハッシュ

手順

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

   git clone https://github.com/kdoronin/telegram_mcp
   cd telegram-mcp
   

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

   npm install
   

   (これにより、必要なパッケージ gramjs、@modelcontextprotocol/sdk、zod などがインストールされます。)

3. .env ファイルを作成して設定します：

   # サンプル .env ファイルをコピー
   cp .env.example .env
   

   .env ファイルを編集し、API_ID と API_HASH を指定します。

4. API ID と API ハッシュを取得します： Telegram の API ID と API ハッシュの取得方法 を参照してください。

🚀 クイックスタート

サーバーの起動

1. インストールが完了したら、プロジェクトのルートディレクトリからサーバーを起動します：

   npm run mcp
   

   初回起動時には、Telegram アカウントの電話番号、2FA パスワード（ある場合）、Telegram パスワード（ある場合）の入力を求められます。

機能のテスト

• サーバーを起動した後、http://localhost:3000 にアクセスすることで MCP サーバーをテストできます。

サポートされているツール

以下は、MCP サーバーがサポートするツールのリストです：

1. executeCode
2. getFiles
3. getGptModels
4. getImages
5. getUpdates
6. initialize
7. setOptions

💻 使用例

基本的な使用法

// 例：更新の取得
await executeTool({
  toolName: "getUpdates",
  parameters: {
    offset: null,
    limit: 10,
    timeout: 0
  }
});

🔧 技術詳細

認証

• 初回起動時には、Telegram アカウントの電話番号、2FA パスワード（ある場合）、Telegram パスワード（ある場合）の入力を求められます。
• 認証に失敗した場合は、sessions/ ディレクトリ内のセッションファイルを削除してから再度試してください。

セッションファイルの構造

セッションファイルは sessions/ ディレクトリに保存され、ファイル名は電話番号（例：+79001234567.json）です。各ファイルには以下の情報が含まれています：

• 暗号化されたセッション文字列
• 作成/更新タイムスタンプ

トラブルシューティング

1. エラー "Your API ID or Hash cannot be empty or undefined"

   • .env ファイルがプロジェクトのルートディレクトリにあることを確認してください。
   • API_ID と API_HASH が正しく入力されていることを確認してください。
   • プロジェクトのルートディレクトリからサーバーを起動してください。

2. サーバーが保存されたセッションを認識しない場合

   • 実行パスがプロジェクトのルートディレクトリであることを確認してください。
   • sessions/ ディレクトリ内にセッションファイルが存在することを確認してください。
   • npm run mcp で起動してみてください。

3. 認証エラー

   • 誤った 2FA パスワードを入力した場合、再度入力するように求められます。
   • すべての試行が失敗した場合は、セッションファイルを削除してから再度試してください。

📄 ライセンス

MIT

⚠️ 重要提示

• あなたの API ID とハッシュを第三者と共有しないでください。
• 信頼できる環境でサーバーを実行してください。
• セッションファイルには機密データが含まれています。適切に保管し、共有しないでください。
• executeMethod ツールは任意の Telegram API メソッドを実行できます。破壊的な操作を実行する可能性があるため、使用時には注意してください。