Telegram MCP Server

Do czego służy serwer “Telegram” MCP?

Serwer Telegram MCP integruje potężne możliwości platformy komunikacyjnej Telegram z protokołem Model Context Protocol (MCP), umożliwiając asystentom AI oraz klientom programistyczną interakcję z Telegramem. Dzięki wykorzystaniu biblioteki Telethon ten serwer pozwala na kompleksową automatyzację i zarządzanie czatami, wiadomościami, grupami oraz interakcjami z użytkownikami w Telegramie. Działa jako most między agentami AI a API Telegrama, umożliwiając wykonywanie takich zadań jak wysyłanie wiadomości, pobieranie historii czatów, zarządzanie grupami i wiele innych. Znacząco usprawnia to przepływ pracy deweloperskiej poprzez usprawnienie komunikacji, umożliwienie zautomatyzowanych odpowiedzi i dostarczenie narzędzi do bezpośredniego pobierania lub modyfikowania danych Telegrama przez narzędzia AI, takie jak Claude, Cursor i inni klienci kompatybilni z MCP.

Lista promptów

Nie udokumentowano żadnych szablonów promptów w dostępnej dokumentacji lub plikach repozytorium.

Lista zasobów

Nie znaleziono wyraźnie udokumentowanych prymitywów zasobów MCP w dostępnych plikach lub README.

Lista narzędzi

• get_chats(page, page_size): Zwraca stronicowaną listę czatów i grup Telegrama dostępnych dla uwierzytelnionego użytkownika. Umożliwia to klientom i modelom LLM przeglądanie oraz wybieranie konwersacji użytkownika do dalszej analizy lub wysyłania wiadomości.

Dokumentacja podaje, że „każda główna funkcja Telegrama/Telethona jest dostępna jako narzędzie”, jednak tylko get_chats jest wymienione z nazwy. Pełna lista narzędzi nie jest przedstawiona w widocznej dokumentacji.

Przykładowe zastosowania tego serwera MCP

• Automatyczne wysyłanie wiadomości: Agenci AI mogą wysyłać wiadomości, multimedia lub pliki do osób i grup na Telegramie, umożliwiając automatyczne powiadomienia, odpowiedzi lub komunikaty masowe.
• Analiza czatów: Pobieranie i analiza historii czatów w celu podsumowania dyskusji, wyodrębnienia zadań do wykonania lub przeprowadzania analizy sentymentu w grupach lub prywatnych rozmowach.
• Zarządzanie grupami: Programistyczne zarządzanie członkostwem, rolami i uprawnieniami w grupach dla usprawnienia administracji społeczności lub zespołu.
• Integracja bota: Używanie serwera do obsługi botów Telegram, które realizują złożone przepływy pracy, przekazują informacje lub działają jako wirtualni asystenci AI.
• Płynne pobieranie danych: Wyodrębnianie konkretnych wiadomości, plików lub szczegółów czatów do integracji z zewnętrznymi systemami, panelami lub bazami danych – wsparcie zaawansowanej automatyzacji.

Jak skonfigurować

Windsurf

1. Wymaganie: Upewnij się, że Node.js jest zainstalowany, a Windsurf skonfigurowany.
2. Zlokalizuj konfigurację: Otwórz plik ustawień lub konfiguracji Windsurf.
3. Dodaj serwer MCP: Wstaw serwer Telegram MCP do sekcji mcpServers:

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

4. Zapisz i uruchom ponownie: Zapisz konfigurację i zrestartuj Windsurf.
5. Zweryfikuj konfigurację: Sprawdź dashboard Windsurf lub logi, aby upewnić się, że telegram-mcp działa.

Zabezpieczanie kluczy API (przykład)

{
  "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. Wymaganie: Upewnij się, że Claude Desktop lub kompatybilny klient Claude jest zainstalowany.
2. Zlokalizuj konfigurację: Edytuj plik claude_desktop_config.json.
3. Dodaj wpis serwera MCP:

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

4. Zapisz i uruchom ponownie: Zapisz plik JSON i uruchom ponownie Claude.
5. Zweryfikuj: Potwierdź, że Claude wykrywa i łączy się z telegram-mcp.

Zabezpieczanie kluczy API (przykład)

{
  "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. Wymaganie: Zainstaluj Node.js i edytor Cursor.
2. Otwórz ustawienia Cursor: Przejdź do sekcji integracji MCP.
3. Dodaj serwer Telegram MCP:

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

4. Uruchom ponownie Cursor: Zapisz ustawienia i uruchom ponownie aplikację Cursor.
5. Zweryfikuj: Potwierdź, czy Cursor rozpoznaje i łączy się z serwerem Telegram MCP.

Zabezpieczanie kluczy API (przykład)

{
  "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. Wymaganie: Upewnij się, że Cline jest zainstalowany i skonfigurowany.
2. Otwórz plik konfiguracyjny: Edytuj ustawienia lub plik konfiguracyjny Cline.
3. Dodaj wpis serwera MCP:

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

4. Zapisz i uruchom ponownie: Zapisz plik i uruchom ponownie Cline.
5. Zweryfikuj: Sprawdź w interfejsie Cline, czy serwer Telegram MCP działa.

Zabezpieczanie kluczy API (przykład)

{
  "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 używać tego MCP w przepływach

Użycie MCP w FlowHunt

Aby zintegrować serwery MCP z przepływem pracy FlowHunt, zacznij od dodania komponentu MCP do swojego przepływu i podłączenia go do agenta AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracji. W sekcji konfiguracji systemowej MCP wstaw szczegóły serwera MCP w tym formacie JSON:

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

Po skonfigurowaniu agent AI może teraz korzystać z tego MCP jako narzędzia, mając dostęp do wszystkich jego funkcji i możliwości. Pamiętaj, aby zamienić “telegram-mcp” na faktyczną nazwę swojego serwera MCP i podać swój własny adres URL serwera MCP.

Przegląd

Wsparcie korzeni: Brak wyraźnej wzmianki
Sampling support: Brak wyraźnej wzmianki

Oceniam Telegram MCP Server na 6/10. Jest funkcjonalnie solidny z jasnymi instrukcjami konfiguracji i zabezpieczenia, ale brakuje mu dokumentacji dotyczącej szablonów promptów, wyraźnych zasobów oraz pełnej listy narzędzi, co jest istotne dla zaawansowanej integracji MCP i przejrzystości.

Wynik MCP