telegram-channel-mcp-server

MCP-Server (stdio) zum Veröffentlichen und Verwalten von Beiträgen in einem Telegram-Kanal über die Bot API. Ermöglicht einem Agenten (Claude Code, Claude Desktop usw.) das Senden von Text, Fotos, Videos, Alben, Dokumenten, Sprachnachrichten, Video-Notizen, Umfragen/Quizzen und kostenpflichtigen Inhalten sowie das Bearbeiten/Löschen/Anpinnen von Beiträgen.

Installation

npm install
npm run build

Related MCP server: Telegram Bot MCP Server

Konfiguration

Claude Code

claude mcp add telegram-channel -e TELEGRAM_BOT_TOKEN=123:ABC -e TELEGRAM_CHAT_ID=-1001234567890 -- node /abs/path/telegram-channel-mcp/dist/index.js

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "telegram-channel": {
      "command": "node",
      "args": ["/abs/path/telegram-channel-mcp/dist/index.js"],
      "env": { "TELEGRAM_BOT_TOKEN": "123:ABC", "TELEGRAM_CHAT_ID": "-1001234567890" }
    }
  }
}

Tools

Medien werden in jedem Tool als Zeichenfolge angegeben: eine öffentliche http(s)-URL, ein absoluter Pfad zu einer lokalen Datei (der Server lädt sie hoch) oder eine Telegram-file_id (im Sendeergebnis zurückgegeben, sodass Sie eine Datei ohne erneutes Hochladen wiederverwenden können).

Schaltflächen sind ein Array von Zeilen: [[{ "text": "Website", "url": "https://…", "style": "primary" }], [{ "text": "Copy", "copy_text": "PROMO" }]]. Genau eines von url / callback_data / copy_text; style: primary | success | danger.

Vom Server behandelte Bot-API-Einschränkungen

• Alben und Video-Notizen können keine Schaltflächen enthalten – senden Sie sie in einer separaten Nachricht.

• In einem Album gilt show_caption_above_media für alle Elemente gleichzeitig.

• Kostenpflichtige Inhalte funktionieren nur in Kanälen, 1-10 000 Sterne.

• Umfragen in Kanälen sind immer anonym.

• Grenzen: Text 4096 Zeichen, Bildunterschrift 1024, Datei 50 MB beim Hochladen / 20 MB per URL.

Entwicklung

npm run dev                        # run from sources
npm run smoke -- /path/to/img.png  # e2e check against a real channel (creates and deletes test posts)
npx @modelcontextprotocol/inspector node dist/index.js

Layout: src/telegram.ts – API-Client und Medienauflösung, src/schemas.ts – gemeinsame Zod-Schemas, src/format.ts – Antwortformatierung, src/tools/* – nach Domäne gruppierte Werkzeuge, src/index.ts – Einstiegspunkt.