🧠 Telegram Bot MCP 服务器

本项目是一个 Telegram 机器人集成，使用 模型上下文协议 (MCP) 构建，它公开了一套有用的工具，用于与 Telegram Bot API 交互。它通过一组结构化的命令（如消息传递、用户管理和机器人配置文件配置）实现与 Telegram 的标准化通信。

---

🚀 功能

此 MCP 服务器公开了以下工具：

✅ get-me

测试您的机器人的身份验证并检索有关机器人的基本信息。

---

💬 send-message

向特定用户或聊天发送纯文本消息。

• 输入:
  • chatId: 目标聊天 ID 或用户名
  • text: 消息内容

---

🖼️ send-photo

发送带有可选标题的照片。

• 输入:
  • chatId: 目标聊天 ID 或用户名
  • media: 文件 ID、URL 或上传的文件
  • text (可选): 照片的标题

---

🔨 kick-chat-member

禁止用户访问群组、超级群组或频道。

• 输入:
  • chatId: 目标聊天
  • userId: 要禁止的用户

---

♻️ un-ban-chat-member

从聊天中取消禁止先前被禁止的用户。

• 输入:
  • chatId: 目标聊天
  • userId: 要取消禁止的用户

---

🧾 get-chat

获取完整的聊天元数据和详细信息。

• 输入:
  • chatId: 目标聊天

---

👥 get-chat-member-count

获取群组或频道中的成员总数。

• 输入:
  • chatId: 目标聊天

---

🔍 get-chat-member

获取有关群组或频道中特定成员的详细信息。

• 输入:
  • chatId: 目标聊天
  • userId: 目标用户

---

✏️ set-my-short-description

更新您的机器人的简短描述（显示在个人资料和分享中）。

• 输入:
  • short_description: 新的简短描述（最多 120 个字符）

---

📄 get-my-short-description

获取机器人当前的简短描述。

---

📝 set-my-commands

设置显示在 Telegram UI 中的命令列表。

• 输入:
  • commands: { command, description } 数组

---

📋 get-my-commands

获取为机器人配置的当前命令列表。

---

🧑‍💻 set-my-name

更新机器人的名称。

• 输入:
  • name: 新的机器人名称

---

🙋 get-my-name

检索机器人当前的名称。

---

📘 set-my-description

更新机器人的完整描述（显示在空聊天中）。

• 输入:
  • description: 新的机器人描述（最多 512 个字符）

---

📖 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 替换为已编译项目入口点的真实路径。

---

💬 支持 & 反馈

请随时提出问题或为项目做出贡献。 有关 Telegram 的具体帮助，请参阅 Telegram Bot API 文档。

请我喝咖啡 :) https://buymeacoffee.com/delkhoshsiv

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。