🧠 Telegram Bot MCP Server

🚀 核心功能

• get-me: 测试机器人认证并获取基本信息。
• send-message: 向特定用户或聊天发送纯文本消息。
• send-photo: 发送带可选标题的图片。
• kick-chat-member: 从群组、超级群组或频道中封禁用户。
• un-ban-chat-member: 解封之前被封禁的用户。
• get-chat: 获取聊天元数据和详细信息。
• get-chat-member-count: 获取群组或频道中的成员总数。
• get-chat-member: 获取群组或频道中特定成员的详细信息。
• set-my-short-description: 更新机器人的简短描述。
• get-my-short-description: 获取当前机器人的简短描述。
• set-my-commands: 设置机器人命令列表。
• get-my-commands: 获取当前机器人命令列表。
• set-my-name: 更新机器人名称。
• get-my-name: 获取当前机器人名称。
• set-my-description: 更新机器人完整描述。
• get-my-description: 获取当前机器人描述。

📦 安装教程

1. 克隆仓库

git clone https://github.com/siavashdelkhosh81/telegram-bot-mcp-server.git
cd telegram-bot-mcp-server

2. 获取 Telegram 机器人令牌

1. 在 Telegram 中搜索 @BotFather。
2. 开始对话并运行命令： /newbot
3. 按照提示命名机器人并获取 API 令牌。
4. 保存令牌。

3. 安装和构建

安装依赖包

yarn

构建项目

yarn build

4. 配置 MCP 客户端

在 MCP 客户端配置中添加以下内容：

{
  "mcpServers": {
    "telegram_bot": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/.build/index.js"],
      "env": {
        "TELEGRAM_BOT_API_TOKEN": "your bot token"
      }
    }
  }
}

🔁 将 /ABSOLUTE/PATH/TO/PARENT/FOLDER/.build/index.js 替换为实际项目入口文件的路径。

💬 调试方式

安装完成后，可以通过以下命令测试机器人功能：

node .build/index.js

确保环境变量 TELEGRAM_BOT_API_TOKEN 已正确设置。

❓ 常见问题解答

1. 如何获取 Telegram 机器人令牌？

2. 通过 @BotFather 创建机器人并获取令牌。

3. 如何更新机器人描述？

4. 使用 set-my-description 工具更新描述。

5. 如何发送消息到特定聊天？

6. 使用 send-message 工具，提供 chatId 和 text 参数。

7. 如何解封用户？

8. 使用 un-ban-chat-member 工具，提供 chatId 和 userId 参数。

9. 如何获取群组成员数量？

10. 使用 get-chat-member-count 工具，提供 chatId 参数。

许可证

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