MCP-Communicator-Telegram

MCP 通讯器（电报）

一个 MCP 服务器，支持通过 Telegram 与用户通信。该服务器提供通过 Telegram 机器人与用户交互的工具，包括提问、发送通知、共享文件以及创建项目存档。

安装

通过 npm（全局）

通过 npx（按需）

要获取您的 Telegram 聊天 ID：

特征

• 通过 Telegram 向用户提问
• 向用户发送通知（无需回复）
• 通过 Telegram 向用户发送文件
• 创建并发送项目 zip 文件（尊重 .gitignore）
• 异步接收响应（无限期等待响应）
• 支持基于回复的消息跟踪
• 安全聊天 ID 验证
• 错误处理和日志记录

先决条件

• Node.js（v14 或更高版本）
• Telegram 机器人令牌（从@BotFather获得）
• 您的 Telegram 聊天 ID（可使用附带的实用程序获取）

安装

1. 克隆存储库：

2. 安装依赖项：

3. 创建 Telegram 机器人：
   • 打开 Telegram 并搜索@BotFather
   • 发送/newbot并按照说明操作
   • 保存您收到的机器人令牌
4. 获取您的聊天 ID：
   • 将.env.example复制到.env
   • 将您的机器人令牌添加到.env文件：
     TELEGRAM_TOKEN=your_bot_token_here
   • 运行聊天 ID 实用程序：
     npm run build node build/get-chat-id.js
   • 向您的机器人发送任何消息
   • 复制控制台中显示的聊天 ID
   • 将聊天 ID 添加到您的.env文件：
     TELEGRAM_TOKEN=your_bot_token_here CHAT_ID=your_chat_id_here

配置

将服务器添加到您的 MCP 设置文件（在 Windows 上通常位于%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json ）：

可用工具

询问用户

通过 Telegram 向用户提出问题并等待他们的回复。

输入模式：

使用示例：

通知用户

通过 Telegram 向用户发送通知消息（无需回复）。

输入模式：

使用示例：

发送文件

通过 Telegram 向用户发送文件。

输入模式：

使用示例：

zip_项目

创建项目目录的 zip 文件（尊重 .gitignore 模式）并通过 Telegram 将其发送给用户。

输入模式：

使用默认目录（当前工作目录）的示例：

特定目录的使用示例：

特征：

• 根据目录名称创建一个名为[project-name]-project.zip的 zip 文件
• 可以压缩任何指定目录或当前工作目录
• 尊重 .gitignore 模式
• 维护档案中的正确文件路径
• 发送后自动清理 zip 文件
• 处理最大 2GB 的文件

发展

构建项目：

以开发模式运行：

注意变化：

清理构建目录：

安全

• 服务器仅响应来自配置的聊天ID的消息
• 环境变量用于敏感配置
• 消息 ID 用于跟踪问题/答案对
• 机器人会忽略没有适当上下文的消息

执照

国际学习中心

作者

qpd-v

版本

0.2.1 # 主要版本升级，新增功能：notify_user、send_file 和 zip_project 工具