telegram-api-mcp

概述

这个 MCP 服务器完整覆盖 Telegram Bot API v9.6，提供了全部 169 个方法作为工具。它包含高级功能如速率限制（全局和每聊天）、熔断器模式、带退避的重试机制和元模式以提高上下文效率。服务器使用 TypeScript 和 Zod 验证进行健壮的参数检查，实现了安全措施如令牌屏蔽和路径遍历保护，并保持最少的依赖（仅 2 个）。代码库采用清晰的架构，具有声明式方法注册，使其易于扩展和维护。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• telegram_find

  Search Telegram Bot API methods by keyword or category

  试试:Search for methods related to polls试试:Find all chat management methods
• telegram_call

  Call any Telegram Bot API method by name with JSON parameters

  试试:Send a message to chat试试:Create a new forum topic试试:Get bot information
• sendMessage

  Send text messages to a chat

  试试:Send 'Hello!' to my channel试试:Send a message with formatting
• sendPhoto

  Send photos to a chat

  试试:Send a photo to group试试:Upload an image from my computer
• sendPoll

  Send polls to a chat

  试试:Create a yes/no poll in my channel试试:Send a quiz with correct answer
• getChat

  Get information about a chat

  试试:Get details about my group试试:Check if chat exists
• banChatMember

  Ban a user from a chat

  试试:Ban user from my group试试:Remove member permanently
• forwardMessage

  Forward messages between chats

  试试:Forward a message to my channel试试:Share message to another group
• editMessageText

  Edit text messages

  试试:Correct a typo in my message试试:Update a message with new information
• getMe

  Get information about the bot

  试试:Show my bot details试试:Check bot username and ID
• setMyCommands

  Set bot commands in the menu

  试试:Add /help and /start commands试试:Update bot command menu
• sendSticker

  Send stickers to a chat

  试试:Send a sticker reaction试试:Share an animated sticker

可对比工具

安装

claude mcp add telegram -- npx telegram-api-mcp -e TELEGRAM_BOT_TOKEN=your_token

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["telegram-api-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_token_from_botfather"
      }
    }
  }
}

git clone https://github.com/timoncool/telegram-api-mcp.git
cd telegram-api-mcp
npm install && npm run build
TELEGRAM_BOT_TOKEN=your_token node dist/index.js

FAQ

什么是元模式，为什么使用它？

元模式只使用 2 个工具（telegram_find 和 telegram_call）而不是 169 个，节省约 99% 的上下文令牌。这在长期对话中很有用，因为维持所有 169 个工具的上下文会过于昂贵。

速率限制如何工作？

服务器实现了令牌桶速率限制，有两个级别：全局（默认 30 请求/秒）和每聊天（默认 20 消息/分钟）。这些限制符合 Telegram 的官方要求，可以防止 API 滥用。

telegram-api-mcp 对比