🚀 Telegram MCP 服务器
一个实现MCP协议的服务器，提供了与 Telegram Bot API 交互的工具。借助此服务，AI 助手能够发送消息并检索机器人信息。
✨ 主要特性
本服务器实现了MCP协议，为开发者提供了与 Telegram Bot API 交互的工具，方便AI助手与Telegram进行消息交互和信息检索。
📦 安装指南
安装依赖项
npm install
启动服务器
node index.js
测试服务
访问 http://localhost:8090 进行测试。
💻 使用示例
工具介绍
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 令牌到你的私聊。
📄 许可证
本项目采用 MIT License 许可协议。
此文档为 NexusX-MCP/telegram-mcp-server 项目的官方指南。