telegram-channel-mcp-server

用于通过 Bot API 在 Telegram 频道中发布和管理帖子的 MCP 服务器（stdio）。 让代理（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 stars。

• 频道中的投票始终是匿名的。

• 限制：文本 4096 字符，说明文字 1024，文件上传 50 MB / 通过 URL 20 MB。

开发

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 schemas， src/format.ts - 响应格式化，src/tools/* - 按领域分组的工具，src/index.ts - 入口点。