🧠 Telegram Bot MCP Server

Name: 🧠 Telegram Bot MCP Server
Author: siavashdelkhosh81

@siavashdelkhosh81

代码仓库

关于 🧠 Telegram Bot MCP Server

Telegram bot mcp server

#telegram-bot #mcp-server #api-integration

基本信息

分类

沟通协作

许可证

MIT

运行时

node

传输方式

stdio

发布者

siavashdelkhosh81

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "telegram-bot-mcp-server": {
      "command": "npx",
      "args": [
        "telegram-bot-mcp-server"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Telegram Bot MCP Server?

Telegram Bot MCP Server is a Model Context Protocol (MCP) server that integrates the Telegram Bot API into AI assistants. It provides tools for sending messages, managing users, and configuring bot settings, with intelligent message splitting and comprehensive error handling. It is designed for developers and AI assistant users who need to interact with Telegram through MCP.

How to use Telegram Bot MCP Server?

Run directly with npx telegram-bot-mcp-server after setting the TELEGRAM_BOT_API_TOKEN environment variable with a bot token from BotFather. Alternatively, install globally or locally via npm and configure your MCP client (e.g., Claude Desktop) with the server command and environment variable.

Key features of Telegram Bot MCP Server

Intelligent message splitting for Telegram’s 4096-character limit
Comprehensive error handling with detailed error codes
NPX support for zero-install execution
Easy integration with MCP clients
Rich API coverage for messaging, user management, and bot configuration
Cross-platform support (Windows, macOS, Linux)

Use cases of Telegram Bot MCP Server

Send long messages or photo captions that automatically split across messages
Manage chat members by banning or unbanning users
Retrieve chat and member information for monitoring
Update bot name, description, and command list remotely
Test bot authentication and retrieve bot details

FAQ from Telegram Bot MCP Server

What are the prerequisites for using this server?

Node.js 18+ and a Telegram Bot Token obtained from @BotFather.

How do I get a Telegram bot token?

Open Telegram, start a chat with @BotFather, send /newbot, follow the prompts to name your bot, and copy the provided API token.

What happens if my message exceeds 4096 characters?

The server automatically splits the message into parts while preserving word boundaries and formatting, and sends them sequentially with part indicators.

What should I do if I get a “No bot token” error?

Set the TELEGRAM_BOT_API_TOKEN environment variable to your bot token before running the server, e.g., export TELEGRAM_BOT_API_TOKEN="your_token_here".