AI导哈

Telegram机器人API服务

一个全功能的Telegram机器人API服务器，支持消息、聊天、贴纸、支付、论坛、故事等多种功能。

  • by FantomaSkaRus1
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 FantomaSkaRus1/telegram-bot-mcp

使用说明

电报机器人mcp

用于MCP（模型上下文协议）的完整Telegram Bot API服务器。 174工具 涵盖整个Bot API-消息、聊天、贴纸、支付、论坛、故事等等。

特性

  • 消息 --发送（文本、照片、视频、音频、文档、位置、投票、骰子、贴纸、媒体组）、编辑、转发、复制、删除、固定/取消固定、反应
  • 聊天 --信息、设置、权限、邀请链接、成员管理、验证
  • 机器人 --命令、配置文件、设置、描述、菜单按钮、管理员权限
  • 贴纸 -创建/编辑/删除贴纸集，上传贴纸，自定义表情符号
  • 支付 --发票、明星交易、礼品、退款
  • 论坛 --创建/编辑/关闭/重新打开/删除主题
  • 故事 --发布、编辑、删除、转发
  • 商业 --业务消息、帐户、连接
  • 游戏 --发送游戏、设置分数、高分
  • 网络钩子 --设置、删除、获取信息

快速开始

npm install

克劳德代码

claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "telegram": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-telegram/index.js"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_token"
      }
    }
  }
}

环境变量

变量 必填 描述
TELEGRAM_BOT_TOKEN 是 来自的Bot令牌 @植物学家
TELEGRAM_DEFAULT_CHAT_ID 否 默认聊天ID（跳过 chat_id 在工具调用中）
TELEGRAM_DEFAULT_THREAD_ID 否 论坛超级组的默认主题/线程ID

项目结构

index.js              # Entry point — registers all tool modules
utils/api.js          # Telegram API client, rate limiting, retry logic
tools/
  messages/           # send, edit, forward, manage
  chat/               # info, settings, invite, members, verify
  bot/                # core, commands, profile, settings
  stickers.js
  payments.js
  forum.js
  stories.js
  business.js
  games.js
  webhook.js

许可证

麻省理工学院

相关 MCP