Telegram MCP server

Telegram MCP サーバー

このサーバーは、Telegram API と AI アシスタントをつなぐブリッジであり、Model Context Protocol に基づいています。

重要

このサーバーを使用する前に、Telegram API Terms of Service を読み、内容を理解していることを確認してください。 Telegram API を不正に使用すると、アカウントが停止される場合があります。

目次

• MCP とは？
• このサーバーでできること
  • 機能
  • プロンプトの例
    • メッセージ管理
    • 整理
    • コミュニケーション
• インストール
  • Homebrew
  • NPX
  • リリースから
    • MacOS
    • Linux
    • Windows
  • ソースから
• 設定
  • 認証
  • クライアントの設定
  • JSON Schema のバージョン
• スターの履歴

MCP とは？

Model Context Protocol（MCP）は、Claude Desktop や Cursor などの AI アプリが、外部のツールやデータソースに接続できるようにするシステムです。ユーザーが主導権を保ちながら、AI アシスタントがローカルサービスや API を利用するための、明確で安全な方法を提供します。

このサーバーでできること

機能

• 現在のアカウント情報を取得する（tool: tg_me）
• 未読の絞り込みを指定してダイアログを一覧表示する（tool: tg_dialogs）
• ダイアログを既読にする（tool: tg_read）
• 指定したダイアログのメッセージを取得する（tool: tg_dialog）
• 任意のダイアログに下書きメッセージを送信する（tool: tg_send）

プロンプトの例

AI アシスタントで使えるプロンプトの例を紹介します。

メッセージ管理

• 「Telegram で重要な未読メッセージがあるか確認して」
• 「Telegram の未読メッセージをすべて要約して」
• 「未読メッセージを読んで分析し、必要に応じて返信の下書きを作成して」
• 「重要度の低い未読メッセージを確認して、概要を簡潔に教えて」

整理

• 「Telegram のダイアログを分析して、フォルダー構成を提案して」
• 「Telegram のチャットを重要度別に分類するのを手伝って」
• 「仕事に関連する会話をすべて見つけて、整理方法を提案して」

コミュニケーション

• 「[topic] に関する更新がないか、特定のチャットを監視して」
• 「[chat] の最新メッセージに対する丁寧な返信を下書きして」
• 「チャットに未回答の質問がないか確認して」

インストール

Homebrew

brew を使って、macOS/Linux にバイナリリリースをインストールできます。

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

npx を使って、最新バージョンを直接実行できます（macOS、Linux、Windows に対応）。

npx -y @chaindead/telegram-mcp

NPX を使用する場合は、標準のコマンドと設定を次のように変更してください。

• 認証コマンドは次のようになります。

npx -y @chaindead/telegram-mcp auth ...

• Claude MCP サーバーの設定は次のようになります。

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

設定手順の詳細については、認証およびクライアントの設定を参照してください。

リリースから

MacOS

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Windows

ソースから

必要条件：

• Go 1.24 以降
• PATH 内に GOBIN があること

go install github.com/chaindead/telegram-mcp@latest

設定

認証

サーバーを使用する前に、Telegram API に接続する必要があります。

1. Telegram API から API ID とハッシュを取得します

2. 次のコマンドを実行します：

   注意： 2FA を有効にしている場合：--password <2fa_password> を追加します

   注意： 既存のセッションを上書きする場合：--new を追加します

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   

   📩 Telegram から受け取ったコードを入力して、API に接続します。

3. 完了です！開発を支援するため、このプロジェクトに ⭐️ を付けてください。

クライアントの設定

Claude Desktop が Telegram MCP サーバーを認識するように設定する例です。

1. Claude Desktop の設定ファイルを開きます：

   • MacOS では、設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json にあります
   • Windows では、設定ファイルは %APPDATA%\Claude\claude_desktop_config.json にあります

   注意： Claude Desktop アプリの設定内から claude_desktop_config.json を見つけることもできます

2. サーバーの設定を追加します

   Claude desktop の場合：

    {
      "mcpServers": {
        "telegram": {
          "command": "telegram-mcp",
          "env": {
            "TG_APP_ID": "<your-app-id>",
            "TG_API_HASH": "<your-api-hash>",
            "PATH": "<path_to_telegram-mcp_binary_dir>",
            "HOME": "<path_to_your_home_directory"
          }
        }
      }
    }
   

   Cursor の場合：

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "env": {
           "TG_APP_ID": "<your-app-id>",
           "TG_API_HASH": "<your-api-hash>"
         }
       }
     }
   }
   

JSON Schema のバージョン

一部の MCP クライアント（例：VS Code）は JSON Schema Draft 2020-12 をサポートしておらず、それを使用するツールを拒否します。--schema-version フラグまたは TG_SCHEMA_VERSION 環境変数を設定すると、JSON Schema のバージョンを上書きできます。

一般的な値：

Star History