MCP.so
登录

Telegram MCP Server

@NexusX-MCP

基本信息

分类

沟通协作

许可证

MIT license

传输方式

stdio

作者

NexusX-MCP

关于 Telegram MCP Server

An MCP server implementation that provides tools for interacting with the [Telegram Bot API](

Telegram MCP Server 配置

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

{
  "mcpServers": {
    "telegram-mcp-server-nexusx-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "dist/index.js"
      ]
    }
  }
}

Telegram MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Telegram MCP Server?

An MCP server that provides tools for interacting with the Telegram Bot API. It allows AI assistants to send messages, retrieve bot information, receive updates, and forward messages programmatically.

How to use Telegram MCP Server?

Set the TELEGRAM_BOT_TOKEN environment variable with your bot token from @BotFather. Install dependencies with npm install, build with npm run build, and run the server with npx @modelcontextprotocol/inspector node dist/index.js. Open http://127.0.0.1:6274 to configure and test the tools.

Key features of Telegram MCP Server

  • get_bot_info: Retrieves basic bot information (no parameters required)
  • send_message: Sends a message to a specified chat (requires chatId and text)
  • get_updates: Receives incoming updates using long polling (optional offset, limit, timeout, allowed_updates)
  • forward_message: Forwards messages between chats (requires chatId, fromChatId, messageId)
  • All tools accept optional parameters for additional Telegram API features

Use cases of Telegram MCP Server

  • AI assistant sending notifications or replies to a Telegram chat
  • Retrieving bot details (name, username, etc.) for verification or display
  • Polling for new messages, channel posts, callback queries, or other updates
  • Forwarding messages from one chat or channel to another
  • Integrating Telegram messaging into automated workflows without a full bot client

常见问题

1

How do I get a Telegram bot token?

Talk to [@BotFather](https://t.me/BotFather) on Telegram, create a new bot with the `/newbot` command, and copy the generated token. Keep it secure.

2

What environment variable is required?

You must set `TELEGRAM_BOT_TOKEN` to your bot token. The token is a string like `110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw`.

3

What runtime or dependencies are needed?

The server requires Node.js and npm. Run `npm install` to install dependencies, then build with `npm run build`.

4

Can I customize message formatting (parse_mode, reply_markup)?

Yes, the `send_message` tool accepts an optional `params` object that includes parameters like `parse_mode`, `reply_markup`, etc.

5

Is the server licensed for commercial use?

Yes, the server is licensed under the MIT License, which permits free use, modification, and distribution.

评论

沟通协作 分类下的更多 MCP 服务器