Telegram MCP Server

Name: Telegram MCP Server
Author: bmwdroch

@bmwdroch

代码仓库

关于 Telegram MCP Server

暂无概览

#telegram #mcp #ai-integration

基本信息

分类

沟通协作

运行时

python

传输方式

stdio

发布者

bmwdroch

配置

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

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y",
        "server-perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

工具

未检测到工具

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

概览

What is Telegram MCP Server?

Telegram MCP Server is an MCP (Model Context Protocol) server that integrates AI agents with Telegram. It allows agents to send messages to a user and wait for their reply in synchronous mode, enabling human-in-the-loop interactions.

How to use Telegram MCP Server?

Use it with MCP‑compatible IDEs (Cursor, WindSurf, VSCode with extensions) by adding the Docker container to your mcp_config.json, providing TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID. The server exposes the sendMessage tool, which you call from your AI agent to send a message and await a user response.

Key features of Telegram MCP Server

Send messages to Telegram users and wait for replies
Configurable timeout (600–3600 seconds)
Supports HTML, Markdown, or plain text message formatting
Synchronous mode – agent pauses until the user responds
Secure token and chat ID storage via environment variables
Ready‑to‑use Docker container for easy deployment

Use cases of Telegram MCP Server

AI agent asks for user approval before proceeding with a critical action
Automated workflow that requires human confirmation at a specific step
Virtual assistant that needs user clarification or additional input
Interactive task execution where the agent waits for user decisions

FAQ from Telegram MCP Server

What prerequisites are needed to use this server?

You need a Telegram bot token (create via @BotFather), your personal chat ID (from @userinfobot), and Docker installed.

How do I configure Telegram MCP Server in my IDE?

Add a Docker‑based MCP server entry to your mcp_config.json file, setting TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID either as environment variables in the env block or via an --env-file.

What parameters does the `sendMessage` tool accept?

It requires agentMessage (the text to send). Optional parameters: timeout (seconds, 600–3600) and parseMode (HTML, Markdown, or null). It returns a JSON with status, userResponse, and timestamp.

Can I run the server without Docker?

The README shows only Docker‑based deployment (via Docker run or Docker Compose). No native Python or Node.js run instructions are provided.

Does Telegram MCP Server store any user data?

The README does not mention data storage. Tokens and chat IDs are provided as environment variables at runtime, and the server only relays messages between the agent and Telegram.