Telegram MCP Server

Čo robí “Telegram” MCP Server?

Telegram MCP Server integruje silné možnosti platformy Telegram s Model Context Protocol (MCP), čím umožňuje AI asistentom a klientom programovateľnú interakciu s Telegramom. Využívaním knižnice Telethon tento server umožňuje komplexnú automatizáciu a správu chatov, správ, skupín a používateľských interakcií v Telegrame. Funguje ako most medzi AI agentmi a API Telegramu, vďaka čomu je možné vykonávať úlohy ako odosielanie správ, získavanie histórie chatov, správa skupín a ďalšie. Výrazne zlepšuje vývojárske workflowy zefektívnením komunikácie, umožnením automatizovaných odpovedí a poskytovaním nástrojov na dotazovanie či úpravu telegramových údajov priamo z AI nástrojov ako Claude, Cursor a ďalších MCP-kompatibilných klientov.

Zoznam šablón výziev

V dostupnej dokumentácii alebo v repozitári neboli uvedené žiadne šablóny výziev.

Zoznam zdrojov

V dostupných súboroch ani README neboli explicitne zdokumentované MCP resource primitives.

Zoznam nástrojov

• get_chats(page, page_size): Vráti stránkovaný zoznam chatov a skupín na Telegrame, ku ktorým má autentifikovaný používateľ prístup. Umožňuje klientom a LLM prehľadávať a vyberať konverzácie na ďalšiu analýzu alebo správu správ.

Dokumentácia uvádza, že „každá hlavná funkcia Telegram/Telethon je dostupná ako nástroj“, no explicitne je spomenutý iba get_chats. Kompletný zoznam nástrojov nie je v dokumentácii uvedený.

Príklady použitia tohto MCP Servera

• Automatizované správy: AI agenti môžu posielať správy, médiá či súbory jednotlivcom alebo skupinám na Telegrame, čím umožňujú automatizované notifikácie, odpovede či hromadné rozosielanie.
• Analýza chatov: Získavanie a analýza histórie chatov na sumarizáciu diskusií, extrakciu úloh či analýzu sentimentu v skupinách alebo súkromných konverzáciách v Telegrame.
• Správa skupín: Programovateľná správa členstva v skupinách, rolí a oprávnení pre efektívnu administráciu komunít alebo tímov.
• Integrácia botov: Server možno použiť na prevádzku Telegram botov, ktorí vykonávajú zložité workflowy, odosielajú informácie alebo slúžia ako AI asistenti.
• Plynulé získavanie údajov: Extrahovanie konkrétnych správ, súborov alebo detailov z chatov na integráciu s externými systémami, dashboardmi alebo databázami a podporu pokročilej automatizácie.

Ako to nastaviť

Windsurf

1. Predpoklad: Uistite sa, že máte nainštalovaný Node.js a nakonfigurovaný Windsurf.
2. Vyhľadajte konfiguráciu: Otvorte vaše nastavenia alebo konfiguračný súbor Windsurf.
3. Pridajte MCP Server: Vložte Telegram MCP server do sekcie mcpServers:

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

4. Uložiť a reštartovať: Uložte konfiguráciu a reštartujte Windsurf.
5. Overiť nastavenie: Skontrolujte dashboard Windsurf alebo logy, či telegram-mcp beží.

Zabezpečenie API kľúčov (prí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. Predpoklad: Uistite sa, že máte nainštalovaný Claude Desktop alebo Claude-kompatibilného klienta.
2. Vyhľadajte konfiguráciu: Upravte súbor claude_desktop_config.json.
3. Pridajte MCP Server:

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

4. Uložiť a reštartovať: Uložte JSON súbor a reštartujte Claude.
5. Overiť: Skontrolujte, či Claude zistí a pripojí sa k telegram-mcp.

Zabezpečenie API kľúčov (prí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. Predpoklad: Nainštalujte Node.js a editor Cursor.
2. Otvorenie nastavení: Prístup k sekcii MCP integrácie.
3. Pridajte Telegram MCP Server:

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

4. Reštartujte Cursor: Uložte nastavenia a reštartujte aplikáciu Cursor.
5. Overiť: Skontrolujte, či Cursor rozpozná a pripojí sa k Telegram MCP serveru.

Zabezpečenie API kľúčov (prí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. Predpoklad: Uistite sa, že Cline je nainštalovaný a nakonfigurovaný.
2. Otvorenie konfiguračného súboru: Upravte vaše Cline nastavenia alebo konfiguračný súbor.
3. Vložte MCP Server:

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

4. Uložiť a reštartovať: Uložte súbor, reštartujte Cline.
5. Overiť: Skontrolujte rozhranie Cline, či Telegram MCP server beží.

Zabezpečenie API kľúčov (prí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>"
      }
    }
  }
}

Ako používať tento MCP vo flowoch

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do vášho FlowHunt workflowu začnite pridaním MCP komponentu do flowu a prepojte ho s AI agentom:

Kliknite na MCP komponent pre otvorenie konfiguračného panelu. V sekcii systémovej MCP konfigurácie vložte detaily vášho MCP servera v tomto JSON formáte:

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

Po nakonfigurovaní môže AI agent používať tento MCP ako nástroj so všetkými jeho funkciami a schopnosťami. Nezabudnite zmeniť “telegram-mcp” na reálny názov vášho MCP servera a URL na vašu vlastnú MCP server URL.

Prehľad

Podpora roots: Nie je explicitne uvedená
Sampling podpora: Nie je explicitne uvedená

Telegram MCP Server by som hodnotil na 6/10. Funkčne je robustný s jasnými inštrukciami na nastavenie a bezpečnosť, no chýba dokumentácia k šablónam výziev, explicitným zdrojom a úplnému zoznamu nástrojov, čo sú dôležité prvky pre pokročilú MCP integráciu a transparentnosť.

MCP skóre