Telegram MCP 服务器

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

工具

Telegram MCP 服务提供以下工具来与 Telegram Bot API 交互：

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

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

创建一个新机器人

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

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

用户名是一个短名称，用于搜索、提及和 t.me 链接。 用户名长度为 5-32 个字符，不区分大小写 - 但只能包含拉丁字符、数字和下划线。 您的机器人的用户名必须以“bot”结尾，例如“tetris_bot”或“TetrisBot”。

该令牌是一个字符串，例如 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw，这是授权机器人并向 Bot API 发送请求所必需的。 确保您的令牌安全并安全地存储它，任何人都可以使用它来控制您的机器人。

与机器人的名称不同，用户名以后无法更改 - 因此请仔细选择。 向 api.telegram.org 发送请求时，请记住在令牌前加上“bot”一词。

开发

npm install

npm run build

npx @modelcontextprotocol/inspector node dist/index.js

打开 http://127.0.0.1:6274 设置环境并与工具交互。

许可证

此 MCP 服务器是在 MIT 许可证下获得许可的。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。