MCP 服务器

MCP-Communicator-Telegram

一个 MCP 服务器，可以通过 Telegram 与用户进行通信。该服务器提供一个工具，可以向用户提问并通过 Telegram 机器人接收他们的回复。

Git管理工具

访问服务器

README

MCP 通讯器 (Telegram)

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

安装

通过 npm (全局安装)

npm install -g mcp-communicator-telegram

通过 npx (按需安装)

npx mcptelegram

获取您的 Telegram 聊天 ID：

npx mcptelegram-chatid

功能特性

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

前提条件

Node.js (v14 或更高版本)
一个 Telegram 机器人令牌（从 @BotFather 获取）
您的 Telegram 聊天 ID（可以使用提供的实用程序获取）

安装步骤

克隆仓库：

git clone https://github.com/qpd-v/mcp-communicator-telegram.git
cd mcp-communicator-telegram

安装依赖：

npm install

创建一个 Telegram 机器人：
- 打开 Telegram 并搜索 @BotFather
- 发送 /newbot 并按照说明操作
- 保存您收到的机器人令牌
获取您的聊天 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）：

{
  "mcpServers": {
    "mcp-communicator-telegram": {
      "command": "node",
      "args": ["path/to/mcp-communicator-telegram/build/index.js"],
      "env": {
        "TELEGRAM_TOKEN": "your_bot_token_here",
        "CHAT_ID": "your_chat_id_here"
      }
    }
  }
}

可用工具

ask_user

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

输入 Schema:

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "要向用户提出的问题"
    }
  },
  "required": ["question"]
}

使用示例：

const response = await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "ask_user",
  arguments: {
    question: "你最喜欢的颜色是什么？"
  }
});

notify_user

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

输入 Schema:

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "要发送给用户的消息"
    }
  },
  "required": ["message"]
}

使用示例：

await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "notify_user",
  arguments: {
    message: "任务已成功完成！"
  }
});

send_file

通过 Telegram 向用户发送文件。

输入 Schema:

{
  "type": "object",
  "properties": {
    "filePath": {
      "type": "string",
      "description": "要发送的文件的路径"
    }
  },
  "required": ["filePath"]
}

使用示例：

await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "send_file",
  arguments: {
    filePath: "path/to/file.txt"
  }
});

zip_project

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

输入 Schema:

{
  "type": "object",
  "properties": {
    "directory": {
      "type": "string",
      "description": "要压缩的目录（默认为当前工作目录）"
    }
  },
  "required": []
}

await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "zip_project",
  arguments: {}
});

使用特定目录的示例：

await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "zip_project",
  arguments: {
    directory: "/path/to/your/project"
  }
});

功能特性：