Telegram MCP Server

🚀 Telegram MCP サーバー

このサーバーはMCP（Multipurpose Control Protocol）サーバーで、AIアシスタント（Claudeなど）がユーザークライアントAPI（ボットAPIではなく）を通じてTelegramアカウントとやり取りできるようにします。このサーバーは@mtproto/coreとFastMCPフレームワークに基づいて構築されています。

✨ 主な機能

ツール

• listChannels

  • サーバーキャッシュに基づいて、現在のアカウントがアクセス可能なTelegramチャンネル/チャットをリストします。
  • パラメータ:
    • limit (number, optional): 返される最大チャンネル数（デフォルト: 50）。
  • 出力: ID、タイトル、タイプ、およびアクセスハッシュ（適用可能な場合）を含むチャンネル/チャットのリスト。

• searchChannels

  • 名前に含まれるキーワードに基づいて、キャッシュ内のチャンネル/チャットを検索します。
  • パラメータ:
    • keywords (string): チャンネル名で検索するキーワード。
    • limit (number, optional): 返される最大結果数（デフォルト: 100）。
  • 出力: 一致するチャンネル/チャットのリスト。

• getChannelMessages

  • 特定のチャンネル/チャットから、そのIDを使用して最新のメッセージを取得します。
  • パラメータ:
    • channelId (number): チャンネル/チャットの数字ID（listChannelsまたはsearchChannelsを通じて取得）。
    • limit (number, optional): 返される最大メッセージ数（デフォルト: 100）。
    • filterPattern (string, optional): テキスト内容に基づいてメッセージをフィルタリングするためのJavaScript互換の正規表現。
  • 出力: ID、日付、テキスト、および送信者IDを含むメッセージのリスト。

📦 インストール

前提条件

1. Node.js: バージョン18以上の使用を推奨します。
2. Telegramアカウント:
   • アクティブなTelegramアカウントが必要です。
   • 二段階認証（2FA） を有効にする必要があります（設定 → プライバシーとセキュリティ → 二段階認証）。
3. Telegram API資格情報:
   • こちらからapi_idとapi_hashを取得してください。

インストール手順

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

   git clone https://github.com/kfastov/telegram-mcp-server.git
   cd telegram-mcp-server
   

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

   npm install
   

🔧 設定

サーバー設定

config.jsonファイルを編集して、以下のパラメータを設定します：

{
  "telegram": {
    "api_id": "YOUR_API_ID",
    "api_hash": "YOUR_API_HASH"
  },
  "port": 8080,
  "session_name": "mcp_session"
}

環境変数

以下のパラメータは環境変数を使用して設定することもできます：

• TELEGRAM_API_ID: あなたのapi_idに置き換えます。
• TELEGRAM_API_HASH: あなたのapi_hashに置き換えます。
• PORT: サーバーが動作するポート（デフォルト: 8080）。
• SESSION_NAME: セッション名（デフォルト: mcp_session）。

🚀 クイックスタート

手動起動

node index.js

PM2を使用したバックグラウンド起動

pm2 start index.js --save

🛠️ トラブルシューティング

• ログインプロンプト: MCPクライアント起動時にサーバーが継続的にログインコード/パスワードを要求する場合は、data/session.jsonファイルが存在し、有効であることを確認してください。セッションを更新するためにnode index.jsを手動で実行する必要がある場合があります。
• キャッシュの問題: チャンネルが古いまたは欠落しているように見える場合は、./data/dialog_cache.jsonファイルを削除し、サーバーを再起動（node index.jsを手動で実行）してキャッシュを強制的に更新してください。これには時間がかかる場合があります。
• モジュールが見つからない: プロジェクトディレクトリでnpm installを実行したことを確認してください。MCPクライアントがサーバーを起動する場合は、作業ディレクトリが正しく設定されているか、絶対パスを使用していることを確認してください。

📚 ドキュメント

このリポジトリには、MCPサーバーを構築するためのtelegram-client.jsという低レベルのライブラリも含まれています。詳細については、LIBRARY.mdを参照してください。

📄 ライセンス

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