Telegram MCP Server

基本能力

产品定位

Telegram MCP Server 是一个用于与 Telegram Bot API 交互的服务，旨在为 AI 助手提供程序化的消息发送和信息获取能力。

核心功能

1. get_bot_info：获取机器人的基本信息，无需参数，返回包含机器人信息的 User 对象。
2. send_message：向指定聊天发送消息，参数包括 chatId（目标聊天的唯一标识符）和 text（消息文本），可选参数包括 parse_mode 和 reply_markup 等。
3. get_updates：通过长轮询接收传入的更新，可选参数包括 offset、limit、timeout 和 allowed_updates，返回包含各种类型更新的数组。
4. forward_message：转发任何类型的消息，参数包括 chatId、fromChatId 和 messageId，可选参数包括 message_thread_id 和 disable_notification 等。

适用场景

1. 自动化消息发送：通过 AI 助手自动发送消息到 Telegram 聊天。
2. 机器人信息管理：获取和管理机器人的基本信息。
3. 实时更新监控：通过长轮询监控 Telegram 聊天中的实时更新。
4. 消息转发：将消息从一个聊天转发到另一个聊天。

工具列表

1. get_bot_info：获取机器人信息。
2. send_message：发送消息到指定聊天。
3. get_updates：接收传入的更新。
4. forward_message：转发消息。

常见问题解答

1. 如何获取机器人令牌？：通过与 @BotFather 对话并创建新机器人来获取令牌。
2. 如何设置环境变量？：设置 TELEGRAM_BOT_TOKEN 环境变量为你的机器人令牌。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 获取 Telegram 机器人令牌。

安装教程

1. 克隆项目仓库。
2. 运行以下命令安装依赖： bash npm install
3. 构建项目： bash npm run build
4. 启动服务： bash npx @modelcontextprotocol/inspector node dist/index.js
5. 打开 http://127.0.0.1:6274 设置环境并交互。

调试方式

1. 确保环境变量 TELEGRAM_BOT_TOKEN 已正确设置。
2. 使用 get_bot_info 工具验证机器人信息是否正确返回。
3. 使用 send_message 工具测试消息发送功能。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。