适合谁
- 使用大型语言模型驱动 Telegram Bot 开发，以自然语言的提示触发 Bot API 调用。
- 希望使用全面、验证过的 Telegram Bot API 方法集合的集成。
- 较长的 AI 对话场景，其中元模式可以减少上下文令牌的使用。
- 需要在 Bot API 调用中内置速率限制和容错能力的应用。
T
51FMRS · D
该服务器提供了对 Telegram Bot API 的全面、类型安全的覆盖，并增强了对 AI 使用的工程功能，但它是社区维护的，在较新的 API 版本方面可能落后。
telegram-api-mcp 是一个仅支持 TypeScript 的 MCP 服务器，它提供了所有 169 种 Telegram Bot API 方法（Bot API v9.6，根据清单为 v10.2）。它包含 Zod 参数验证、令牌掩码、工具注解、响应截断以及用于速率限制的异步互斥令牌桶（默认全局每秒 30 个请求，每个群组每分钟 20 条消息，符合 Telegram 官方限制）和 3 态断路器（关闭/打开/半开）等弹性特性。它支持元模式（TELEGRAM_META_MODE=true），可以仅用两个工具 telegram_find 和 telegram_call 取代 169 个单独的工具，以节省大约 99% 的上下文令牌。运行时依赖仅有两个（@modelcontextprotocol/sdk 和 zod）。服务器通过标准输入/输出与客户端通信。根据 README 中的安装说明，它通过 npx 与包括 Claude Desktop 在内的客户端兼容。
工具能力
telegram_find
按关键词或类别搜索可用的 Telegram 方法。
telegram_call
使用 JSON 参数按名称调用任何 Telegram Bot API 方法。
sendMessage
sendPhoto
sendVideo
sendAudio
sendDocument
sendMediaGroup
sendPoll
sendDice
sendChatAction
forwardMessage
copyMessage
editMessageText
deleteMessage
getMe
getChat
banChatMember
unbanChatMember
restrictChatMember
promoteChatMember
getFile
getUpdates
setWebhook
answerCallbackQuery
sendInvoice
createChatInviteLink
setChatTitle
sendLocation
sendContact
安装接入
- 从 @BotFather 获取一个机器人令牌。 2. 在支持 MCP 的客户端（例如 Claude Desktop）中，添加一个包含以下配置的 MCP 服务器：
command: 'npx'，args: ['telegram-api-mcp']，env: { TELEGRAM_BOT_TOKEN: 'your_token' }。 3. 或者，在您的 shell 中设置环境变量，然后运行npx telegram-api-mcp，同时搭配一个可以实现 MCP 的客户端。
claude_desktop_config.json
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": [
"telegram-api-mcp"
],
"env": {
"TELEGRAM_BOT_TOKEN": "your_token_from_botfather"
}
}
}
}
选型与风险
不适合谁
- 非 Telegram 用户或对 Bot API 没有需求的人。
- 需要 SSE 或 HTTP 传输的用户，因为该服务器仅使用 stdio。
- 需要一个拥有官方归属的 MCP 服务器的用户；这是社区实现的。
- 无需外部依赖和需要全面官方支持的极端情况。
所需权限
- 完全访问与提供的令牌相关联的 Telegram Bot API。
- Bot 令牌有效的聊天、群组、频道及文件中发送和接收消息的能力。
- 服务器仅通过 `api.telegram.org` 进行通信；不需要其他外部网络请求。
- 令牌不会被暴露在响应或错误消息中。
风险与副作用
- 泄露令牌会导致机器人账户被滥用。
- 在不受信任的环境中，如果启用了文件上传权限，则可能导致安全风险。
- 速率限制和断路机制可能导致在压力下行为有所不同。
- 服务器的代码和内容可能存在错误，没有官方支持。
常见排障
- 检查 `TELEGRAM_BOT_TOKEN` 是否在环境中正确设置。
- 验证您的 Telegram Bot 令牌是否有效以及 Bot 是否已初始化。
- 确保您的客户端通过 npx 安装了最新版本的 `telegram-api-mcp`。
- 对于消息发送错误，请检查速率限制配置和聊天 ID 的准确性。
使用场景
在 MCP 客户端内发送 Telegram 消息、音频、照片、视频、文档和媒体组。
直接管理聊天、群组、论坛话题和成员权限。
无需在客户端手动编写 REST 调用即可实现 Telegram Bot 操作。
在 Telegram 中创建轮询、测验、发票和赠品。
支持客户端
Claude Desktop完整支持