Telegram MCP Server 使用说明

项目简介

Telegram MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 AI 助手提供与 Telegram 平台交互的能力。它通过 MCP 协议将 Telegram Bot API 的功能封装成标准化的工具，使 AI 助手能够方便地发送消息、发送照片以及删除 Telegram 消息。

主要功能点

消息发送: 支持向指定的 Telegram 聊天发送文本消息。
照片发送: 支持向指定的 Telegram 聊天发送照片，并可附带可选的文字说明。
消息删除: 支持删除指定 Telegram 聊天中的特定消息。
MCP 协议支持: 完全兼容 Model Context Protocol，可以与任何 MCP 客户端无缝集成。
易于部署: 使用 Node.js 和 npm 构建，安装配置简单快捷。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
克隆仓库: 将 GitHub 仓库 'telegram-mcp-server' 克隆到本地。
进入项目目录: 在终端中进入克隆的项目目录。
安装依赖: 运行命令 'npm install' 安装项目所需的依赖包。

配置环境变量: 在项目根目录下创建 '.env' 文件，并添加你的 Telegram Bot Token：

TELEGRAM_BOT_TOKEN=你的Telegram机器人Token

构建项目: 运行命令 'npm run build' 构建 TypeScript 项目。
启动服务器: 运行命令 'npm start' 启动 MCP 服务器。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端，请在客户端的配置文件中添加以下服务器配置信息。请根据实际的项目 'dist' 目录路径修改 'args' 中的路径。

{
  "mcpServers": {
    "telegram": {  // 服务器名称，可以自定义
      "command": "node", // 启动服务器的命令，这里使用 node
      "args": ["path/to/telegram-mcp-server/dist/telegram-mcp.js"], // 命令参数，指向编译后的服务器 JavaScript 文件路径
      "env": {
        "TELEGRAM_BOT_TOKEN": "你的Telegram机器人Token" // 环境变量，用于传递 Telegram Bot Token
      }
    }
  }
}

基本使用方法

服务器启动并配置到 MCP 客户端后，即可在客户端中使用以下操作（工具）与 Telegram 进行交互：

sendMessage: 发送消息工具，用于向 Telegram 聊天发送文本消息。需要指定 'chatId' (聊天ID) 和 'text' (消息内容) 参数。
sendPhoto: 发送照片工具，用于向 Telegram 聊天发送照片。需要指定 'chatId' (聊天ID) 和 'photoUrl' (照片URL) 参数，可选参数 'caption' (照片描述)。
deleteMessage: 删除消息工具，用于删除 Telegram 聊天中的消息。需要指定 'chatId' (聊天ID) 和 'messageId' (消息ID) 参数。

具体工具调用格式可以参考仓库 README.md 文件中的 "Usage Example" 部分。

Telegram MCP Server