Telegram MCP 服务器

一个实现MCP协议的服务器，提供与 Telegram Bot API 交互的工具。此服务允许 AI 助手发送消息和检索机器人信息。

工具

get_bot_info

获取机器人基本信息。

• 无参数要求
• 返回包含机器人信息的 User 对象

send_message

向指定聊天发送消息。

• chatId：目标聊天的唯一标识符（可以是字符串或数字）
• text：要发送的消息文本
• params（可选）：附加消息参数（例如 parse_mode、reply_markup 等）

get_updates

使用长轮询接收传入更新。

• params（可选）：包含可选参数的对象：
  • offset（可选）：要返回的第一个更新标识符
  • limit（可选）：限制获取的更新数量（1-100）
  • timeout（可选）：长轮询超时时间（秒）
  • allowed_updates（可选）：接收的更新类型数组
• 返回包含各种更新类型的 Update 对象数组：
  • 消息和编辑后的消息
  • 频道帖子
  • 商业信息
  • 行为查询
  • 回调查询
  • 货物查询
  • 预检查出查询
  • 投票及其回答
  • 聊天成员更新
  • 加入聊天请求
  • 聊天提升

forward_message

转发任何类型的消息。服务消息和包含受保护内容的消息无法被转发。

• chatId：目标聊天的唯一标识符或频道用户名（格式为 @channelusername）
• fromChatId：原始消息发送的聊天唯一标识符（或频道用户名，格式为 @channelusername）
• messageId：在 from_chat_id 指定聊天中消息的标识符
• params（可选）：包含可选参数的对象：
  • message_thread_id（可选）：目标消息线程（主题）的唯一标识符（仅限论坛超级群组）
  • video_start_timestamp（可选）：转发视频的新起始时间戳
  • disable_notification（可选）：静默发送消息。用户将收到无声音的通知。
  • protect_content（可选）：保护转发消息的内容，防止被转发和保存
• 成功返回发送的 Message 对象

配置

环境变量

需要设置以下环境变量：

TELEGRAM_BOT_TOKEN=your_bot_token

你可以通过与 @BotFather 机器人在 Telegram 上对话并创建一个新的机器人来获取你的机器人令牌。

创建新机器人

使用 /newbot 命令创建一个新机器人。@BotFather 将要求你提供一个名称和用户名，然后生成一个用于授权机器人的身份验证令牌。

机器人的名称显示在联系详情和其他地方。

用户名是短名称，用于搜索、提及和 t.me 链接。用户名长度为 5-32 字符，并且不区分大小写 – 但只能包含拉丁字符、数字和 underscores。你的机器人将无法直接通过 @username 接收消息，除非你拥有一个 Telegram Channel。

完成后，@BotFather 将发送新的 Telegram Bot API 令牌到你的私聊。

开发步骤

1. 安装依赖项：

npm install

2. 启动服务器：

node index.js

3. 访问 http://localhost:8090 进行测试。

许可证

MIT License

此文档为 NexusX-MCP/telegram-mcp-server 项目的官方指南。