Telegram MCP Server

Telegram MCP 服务

一个用于 Telegram Bot API 的 Model Context Protocol 服务，允许 AI 助手使用标准化工具与 Telegram 交互。

设置

1. 安装依赖：

   npm install
   

2. 创建一个 .env 文件，并填写 Telegram Bot Token：

   TELEGRAM_BOT_TOKEN=your_bot_token_here
   

3. 构建 TypeScript 项目：

   npm run build
   

4. 启动服务：

   npm start
   

MCP 客户端配置

要将此服务与 MCP 客户端搭配使用，请将以下配置添加到 MCP 客户端的配置文件中：

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["path/to/telegram-mcp-server/dist/telegram-mcp.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

支持的操作

Telegram MCP 服务支持以下操作：

• sendMessage：向聊天发送文本消息
• sendPhoto：向聊天发送照片，并可选择添加说明文字
• deleteMessage：删除聊天中的消息

使用示例

此服务实现了 Model Context Protocol，因此可与任何兼容 MCP 的客户端搭配使用。以下是一些调用格式示例：

发送消息：

{
  "operation": "sendMessage",
  "chatId": 123456789,
  "text": "Hello from the Telegram MCP Server!"
}

发送照片：

{
  "operation": "sendPhoto",
  "chatId": 123456789,
  "photoUrl": "https://example.com/image.jpg",
  "caption": "Check out this photo!"
}

删除消息：

{
  "operation": "deleteMessage",
  "chatId": 123456789,
  "messageId": 987654321
}

实现详情

此服务使用：

• Model Context Protocol SDK
• Telegram Bot API
• TypeScript