telegram-mcp

Ein Model Context Protocol (MCP)-Server für die Interaktion mit Telegram unter Verwendung von mtcute.

Funktionen

• Senden von Textnachrichten an Chats

• Warten auf eingehende Nachrichten in bestimmten Chats

• Lesen von Nachrichten aus Chats

• Suchen von Nachrichten

• Auflisten und Abrufen von Informationen über Dialoge (Chats)

• Abrufen aktueller Nachrichten aus allen Chats

• Festlegen und Überprüfen von Emoji-Status-IDs für Konten und Kanäle

Related MCP server: io.github.daedalus/mcp-telegram-bot

Einrichtung

Installation

Option 1: Vorgefertigte Binärdatei herunterladen

Laden Sie das neueste Release für Ihre Plattform von der Releases-Seite herunter:

• macOS (Apple Silicon): telegram-mcp-darwin-arm64.tar.gz

• macOS (Intel): telegram-mcp-darwin-x64.tar.gz

• Linux: telegram-mcp-linux-x64.tar.gz

• Windows: telegram-mcp-win-x64.exe.zip

Entpacken Sie das Archiv und machen Sie die Binärdatei ausführbar (Unix-Systeme):

tar -xzf telegram-mcp-*.tar.gz
chmod +x telegram-mcp

Option 2: Aus dem Quellcode erstellen

1. Klonen Sie das Repository und installieren Sie die Abhängigkeiten:

   git clone git@github.com:zhigang1992/telegram-mcp.git
   cd telegram-mcp
   bun install

2. Erstellen Sie die ausführbare Datei:

   bun run build

Erstkonfiguration (nur beim ersten Mal)

1. Holen Sie sich Ihre Telegram-API-Zugangsdaten von https://my.telegram.org

2. Führen Sie die Ersteinrichtung durch, um sich bei Telegram zu authentifizieren:

   export API_ID=your_api_id
   export API_HASH=your_api_hash
   ./telegram-mcp

   Der Server wird:

   • Sie auffordern, Ihre Telefonnummer einzugeben

   • Ihnen einen Bestätigungscode per Telegram senden

   • Nach dem Bestätigungscode fragen

   • Den absoluten Speicherpfad anzeigen (diesen benötigen Sie für die MCP-Konfiguration)

3. Notieren Sie sich den in der Ausgabe angezeigten Speicherpfad. Er sieht in etwa so aus:

   Storage path: /Users/username/telegram-mcp/bot-data/session

Verwendung

Als MCP-Server

Fügen Sie dies Ihrer Claude Desktop-Konfiguration unter Verwendung des Speicherpfads aus der Ersteinrichtung hinzu:

{
  "mcpServers": {
    "telegram": {
      "command": "/path/to/telegram-mcp",
      "env": {
        "API_ID": "your_api_id",
        "API_HASH": "your_api_hash",
        "TELEGRAM_STORAGE_PATH": "/absolute/path/from/initial/setup"
      }
    }
  }
}

Wichtig: Der TELEGRAM_STORAGE_PATH muss der absolute Pfad sein, der während der Ersteinrichtung angezeigt wurde. Dies stellt sicher, dass der MCP-Server die authentifizierte Sitzung verwendet.

Verfügbare Tools

Nachrichten-Tools

• messages_sendText - Senden einer Textnachricht an einen Chat

  • chatId (erforderlich): Chat-/Benutzer-ID oder Benutzername

  • text (erforderlich): Zu sendender Nachrichtentext

  • replyToMessageId: Optionale Nachrichten-ID, auf die geantwortet werden soll

• messages_getHistory - Abrufen des Nachrichtenverlaufs aus einem Chat

  • chatId (erforderlich): Chat-/Benutzer-ID oder Benutzername

  • limit: Anzahl der Nachrichten (Standard: 100, Maximum: 100)

  • offsetId: Nachrichten-ID für die Paginierung

• messages_search - Suchen nach Nachrichten

  • query (erforderlich): Suchanfrage

  • chatId: Spezifischer Chat für die Suche (optional)

  • limit: Anzahl der Ergebnisse (Standard: 50)

• messages_getRecent - Abrufen aktueller Nachrichten aus allen Chats

  • limit: Anzahl der Chats (Standard: 10)

  • messagesPerChat: Nachrichten pro Chat (Standard: 10)

Interaktive Tools

• wait_for_reply - Warten auf die nächste Nachricht in einem Chat

  • chatId (erforderlich): Chat-/Benutzer-ID oder Benutzername, von dem eine Nachricht erwartet wird

  • timeoutSeconds: Timeout in Sekunden (Standard: 60, Maximum: 300)

Status-Tools

• status_getCurrent - Abrufen des aktuellen Emoji-Status für einen Peer

  • peerId: Ziel-Peer, Standard ist self

• status_setEmoji - Festlegen oder Löschen eines Emoji-Status

  • peerId: Ziel-Peer, Standard ist self

  • emojiId: Benutzerdefinierte Emoji-Dokument-ID, erforderlich, sofern nicht clear=true

  • isCollectible: Auf true setzen, wenn emojiId eine Sammler-ID ist

  • until: Optionaler ISO-8601-Zeitstempel oder Unix-Zeitstempel-String

  • clear: Löscht den aktuellen Status, anstatt einen neuen festzulegen

• status_listAvailable - Auflisten verfügbarer Standard-Emoji-Status-IDs

  • scope: self oder channel (Standard: self)

  • limit: Maximale Anzahl der zurückzugebenden IDs (Standard: 100)

• status_listCollectibles - Auflisten der eigenen Sammler-IDs, die als eigener Emoji-Status verwendet werden können

  • owner: Zu überprüfender Peer, Standard ist self

  • limit: Maximale Anzahl der zurückzugebenden Sammlerstücke (Standard: 100)

Dialog-Tools

• dialogs_list - Auflisten aller Dialoge

  • limit: Maximale Anzahl der Dialoge (Standard: 50)

  • filter: Filteroptionen (onlyUsers, onlyGroups, onlyChannels)

• dialogs_getInfo - Abrufen detaillierter Dialoginformationen

  • chatId (erforderlich): Chat-/Benutzer-ID oder Benutzername

Entwicklung

Im Entwicklungsmodus ausführen:

bun run dev

Der Server speichert Sitzungsdaten im Verzeichnis bot-data/.