mcp-telegram/mcp-telegram-cloud

Was macht mcp-telegram-cloud?

Open-Source-MCP-Server, der Telegram mit Claude AI und ChatGPT verbindet. Nachrichten lesen, Chats durchsuchen, Medien herunterladen – von Grund auf schreibgeschützt. Kostenlos gehostet auf mcp-telegram.com oder selbst hosten mit Docker.

Funktionen

• Nachrichten lesen: Greifen Sie auf Ihren Nachrichtenverlauf zu.
• Chats durchsuchen: Finden Sie Nachrichten nach Inhalt.
• Medien herunterladen: Rufen Sie Fotos, Videos und Dokumente ab – alles schreibgeschützt.
• Cloud- oder Self-Hosted-Betrieb: Nutzen Sie den freien Cloud-Dienst oder hosten Sie ihn selbst.
• UI-Paket für Claude Desktop: Nahtlose Integration in Claude Desktop über das MCP UI-Paket.
• Client-Kompatibilität: Funktioniert mit Claude Desktop, Cursor, Cody und Sourcegraph.

Schnellstart

Cloud-Version (kostenlos)

Besuchen Sie mcp-telegram.com, um die Cloud-Version kostenlos zu nutzen. Keine Einrichtung erforderlich.

Selbst hosten mit Docker

1. Klonen Sie das Repository:

git clone https://github.com/mcp-telegram/mcp-telegram.git
cd mcp-telegram

2. Starten Sie den Server:

docker compose up

Die API ist dann unter http://localhost:3000 verfügbar.

Konfiguration

Claude Desktop

Fügen Sie folgende Konfiguration zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["path/to/telegram-mcp-server/index.js"],
      "env": {
        "TELEGRAM_API_ID": "ihre-api-id",
        "TELEGRAM_API_HASH": "ihr-api-hash",
        "TELEGRAM_SESSION": "ihre-session-datei"
      }
    }
  }
}

Cursor

Fügen Sie in .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["path/to/telegram-mcp-server/index.js"],
      "env": {
        "TELEGRAM_API_ID": "ihre-api-id",
        "TELEGRAM_API_HASH": "ihr-api-hash",
        "TELEGRAM_SESSION": "ihre-session-datei"
      }
    }
  }
}

API-Referenz

Nachrichten lesen

GET /messages?chat_id={chat_id}&limit={limit}

Chats durchsuchen

GET /search?q={query}&limit={limit}

Medien herunterladen

GET /media/{message_id}

Umgebungsvariablen

Variable	Beschreibung	Erforderlich
TELEGRAM_API_ID	Ihre Telegram-API-ID	Ja
TELEGRAM_API_HASH	Ihr Telegram-API-Hash	Ja
TELEGRAM_SESSION	Pfad zur Sitzungsdatei	Ja
PORT	Server-Port (Standard: 3000)	Nein

Lizenz

MIT