Telegram MCP Server

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 文件。