Telegram MCP Server

K čemu slouží “Telegram” MCP Server?

Telegram MCP Server integruje výkonné možnosti platformy Telegram s protokolem Model Context Protocol (MCP), což umožňuje AI asistentům a klientům programově komunikovat s Telegramem. Pomocí knihovny Telethon tento server umožňuje komplexní automatizaci a správu chatů, zpráv, skupin a interakcí s uživateli v rámci Telegramu. Funguje jako most mezi AI agenty a API Telegramu a umožňuje provádět úkony jako posílání zpráv, stahování historie chatů, správu skupin a další. Tím výrazně zefektivňuje vývojářské workflow díky zjednodušené komunikaci, automatizovaným odpovědím a poskytuje nástroje pro dotazování či úpravu dat v Telegramu přímo z AI nástrojů jako Claude, Cursor a dalších klientů kompatibilních s MCP.

Seznam promptů

V dostupné dokumentaci ani v souborech repozitáře nebyly uvedeny žádné šablony promptů.

Seznam zdrojů

V dostupných souborech ani v README nejsou explicitně zdokumentovány žádné MCP resource primitives.

Seznam nástrojů

• get_chats(page, page_size): Vrací stránkovaný seznam chatů a skupin Telegramu dostupných ověřenému uživateli. Umožňuje klientům a LLM procházet a vybírat konverzace uživatele pro další analýzu nebo zasílání zpráv.

V dokumentaci je uvedeno, že “každá hlavní funkce Telegramu/Telethon je dostupná jako nástroj”, ale explicitně je zmíněn pouze get_chats. Úplný seznam nástrojů není v dokumentaci uveden.

Příklady použití tohoto MCP Serveru

• Automatizované zasílání zpráv: AI agenti mohou posílat zprávy, média nebo soubory jednotlivcům či skupinám na Telegramu, což umožňuje automatizovaná oznámení, odpovědi nebo hromadné rozesílání.
• Analýza chatů: Získejte a analyzujte historii chatů pro sumarizaci diskuzí, vyhledání akčních bodů nebo analýzu sentimentu ve skupinách či soukromých konverzacích na Telegramu.
• Správa skupin: Programově spravujte členy skupin, uživatelské role a oprávnění pro efektivní administraci komunit nebo týmů.
• Integrace botů: Provozujte pomocí serveru Telegram boty, kteří zvládají složité workflow, přenášejí informace nebo slouží jako AI asistenti.
• Bezproblémové získávání dat: Extrahujte konkrétní zprávy, soubory nebo detaily chatů pro integraci s externími systémy, dashboardy či databázemi a podpořte pokročilou automatizaci.

Jak nastavit

Windsurf

1. Předpoklad: Ujistěte se, že máte nainstalovaný Node.js a nakonfigurovaný Windsurf.
2. Najděte konfiguraci: Otevřete nastavení nebo konfigurační soubor Windsurfu.
3. Přidejte MCP Server: Vložte Telegram MCP server do sekce mcpServers:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Uložte a restartujte: Uložte konfiguraci a restartujte Windsurf.
5. Ověřte nastavení: Zkontrolujte dashboard nebo logy Windsurfu, zda telegram-mcp běží.

Zabezpečení API klíčů (příklad)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. Předpoklad: Ujistěte se, že máte nainstalovaný Claude Desktop nebo kompatibilního klienta.
2. Najděte konfiguraci: Upravte soubor claude_desktop_config.json.
3. Přidejte MCP Server:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Uložte a restartujte: Uložte JSON soubor a restartujte Claude.
5. Ověřte: Ujistěte se, že Claude detekuje a připojí se k telegram-mcp.

Zabezpečení API klíčů (příklad)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. Předpoklad: Nainstalujte Node.js a editor Cursor.
2. Otevřete nastavení Cursoru: Přejděte do sekce MCP integrací.
3. Přidejte Telegram MCP Server:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Restartujte Cursor: Uložte nastavení a restartujte aplikaci Cursor.
5. Ověřte: Ujistěte se, že Cursor rozpoznal a připojil se k Telegram MCP serveru.

Zabezpečení API klíčů (příklad)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. Předpoklad: Ujistěte se, že máte nainstalovaný a nastavený Cline.
2. Otevřete konfigurační soubor: Upravte nastavení nebo konfigurační soubor Cline.
3. Vložte MCP Server:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Uložte a restartujte: Uložte soubor a restartujte Cline.
5. Ověřte: Zkontrolujte rozhraní Cline, zda běží Telegram MCP server.

Zabezpečení API klíčů (příklad)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Jak používat tento MCP v tocích

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt začněte přidáním MCP komponenty do svého toku a jejím propojením s AI agentem:

Klikněte na komponentu MCP pro otevření panelu konfigurace. V sekci systémové konfigurace MCP vložte detaily MCP serveru v tomto formátu JSON:

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po nastavení může nyní AI agent využívat tento MCP jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “telegram-mcp” na skutečný název vašeho MCP serveru a URL na vaši vlastní adresu MCP serveru.

Přehled

Podpora rootů: Není výslovně zmíněno
Podpora vzorkování: Není výslovně zmíněno

Telegram MCP Server bych hodnotil na 6/10. Funkčně je robustní s jasným postupem nastavení i zabezpečení, ale chybí dokumentace pro šablony promptů, explicitní resources a kompletní výčet nástrojů, což je důležité pro pokročilou MCP integraci i přehlednost.

MCP skóre