Telegram MCP Server

Telegram MCP サーバー

Telegram Bot API 用の Model Context Protocol サーバーです。AI アシスタントが標準化されたツールを使用して Telegram とやり取りできます。

セットアップ

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

   npm install
   

2. Telegram Bot Token を含む .env ファイルを作成します：

   TELEGRAM_BOT_TOKEN=your_bot_token_here
   

3. TypeScript プロジェクトをビルドします：

   npm run build
   

4. サーバーを起動します：

   npm start
   

MCP クライアントの設定

このサーバーを MCP クライアントで使用するには、MCP クライアントの設定ファイルに次の設定を追加します：

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["path/to/telegram-mcp-server/dist/telegram-mcp.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

対応している操作

Telegram MCP サーバーでは、次の操作をサポートしています：

• sendMessage：チャットにテキストメッセージを送信します
• sendPhoto：任意のキャプションを付けて、チャットに写真を送信します
• deleteMessage：チャットからメッセージを削除します

使用例

このサーバーは Model Context Protocol を実装しているため、MCP 互換クライアントであればどれでも使用できます。呼び出し形式の例を以下に示します：

メッセージを送信する：

{
  "operation": "sendMessage",
  "chatId": 123456789,
  "text": "Hello from the Telegram MCP Server!"
}

写真を送信する：

{
  "operation": "sendPhoto",
  "chatId": 123456789,
  "photoUrl": "https://example.com/image.jpg",
  "caption": "Check out this photo!"
}

メッセージを削除する：

{
  "operation": "deleteMessage",
  "chatId": 123456789,
  "messageId": 987654321
}

実装の詳細

このサーバーでは、次のものを使用しています：

• Model Context Protocol SDK
• Telegram Bot API
• TypeScript