telegram-channel-mcp-server

MCP-сервер (stdio) для публикации и управления постами в Telegram-канале через Bot API. Позволяет агенту (Claude Code, Claude Desktop и т.д.) отправлять текст, фотографии, видео, альбомы, документы, голосовые сообщения, видеозаметки, опросы/викторины и платный контент, а также редактировать, удалять и закреплять посты.

Установка

npm install
npm run build

Related MCP server: Telegram Bot MCP Server

Конфигурация

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" }
    }
  }
}

Инструменты

Медиа в каждом инструменте задаётся строкой: публичный http(s) URL, абсолютный путь к локальному файлу (сервер загружает его) или Telegram file_id (возвращается в результате отправки, так что файл можно использовать повторно без повторной загрузки).

Кнопки — это массив рядов: [[{ "text": "Website", "url": "https://…", "style": "primary" }], [{ "text": "Copy", "copy_text": "PROMO" }]]. Ровно одно из url / callback_data / copy_text; style: primary | success | danger.

Ограничения Bot API, обрабатываемые сервером

• Альбомы и видеозаметки не могут содержать кнопки — отправляйте их отдельным сообщением.

• В альбоме show_caption_above_media применяется сразу ко всем элементам.

• Платный контент работает только в каналах, 1–10 000 звёзд.

• Опросы в каналах всегда анонимные.

• Лимиты: текст 4096 символов, подпись 1024, файл 50 МБ при загрузке / 20 МБ по URL.

Разработка

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

Структура: src/telegram.ts — API-клиент и разрешение медиа, src/schemas.ts — общие zod-схемы, src/format.ts — форматирование ответов, src/tools/* — инструменты, сгруппированные по доменам, src/index.ts — точка входа.