Telegram MCP Server Oor

🚀 Telegram MCP 服務器

一個實現MCP協議的服務器，它提供了與 Telegram Bot API 交互的工具。藉助此服務，AI 助手能夠發送消息並檢索機器人信息。

🚀 快速開始

配置環境變量

需要設置以下環境變量：

TELEGRAM_BOT_TOKEN=your_bot_token

你可以通過與 @BotFather 機器人在 Telegram 上對話並創建一個新的機器人來獲取你的機器人令牌。

創建新機器人

使用 /newbot 命令創建一個新機器人。@BotFather 將要求你提供一個名稱和用戶名，然後生成一個用於授權機器人的身份驗證令牌。

機器人的名稱顯示在聯繫詳情和其他地方。

用戶名是短名稱，用於搜索、提及和 t.me 鏈接。用戶名長度為 5 - 32 字符，並且不區分大小寫 – 但只能包含拉丁字符、數字和下劃線。你的機器人將無法直接通過 @username 接收消息，除非你擁有一個 Telegram Channel。

完成後，@BotFather 將發送新的 Telegram Bot API 令牌到你的私聊。

開發步驟

1. 安裝依賴項：

npm install

2. 啟動服務器：

node index.js

3. 訪問 http://localhost:8090 進行測試。

✨ 主要特性

本服務器提供了一系列實用工具，用於與 Telegram Bot API 進行交互，具體如下：

get_bot_info

獲取機器人基本信息。

• 無參數要求
• 返回包含機器人信息的 User 對象

send_message

向指定聊天發送消息。

• chatId：目標聊天的唯一標識符（可以是字符串或數字）
• text：要發送的消息文本
• params（可選）：附加消息參數（例如 parse_mode、reply_markup 等）

get_updates

使用長輪詢接收傳入更新。

• params（可選）：包含可選參數的對象：
  • offset（可選）：要返回的第一個更新標識符
  • limit（可選）：限制獲取的更新數量（1 - 100）
  • timeout（可選）：長輪詢超時時間（秒）
  • allowed_updates（可選）：接收的更新類型數組
• 返回包含各種更新類型的 Update 對象數組：
  • 消息和編輯後的消息
  • 頻道帖子
  • 商業信息
  • 行為查詢
  • 回調查詢
  • 貨物查詢
  • 預檢查出查詢
  • 投票及其回答
  • 聊天成員更新
  • 加入聊天請求
  • 聊天提升

forward_message

轉發任何類型的消息。服務消息和包含受保護內容的消息無法被轉發。

• chatId：目標聊天的唯一標識符或頻道用戶名（格式為 @channelusername）
• fromChatId：原始消息發送的聊天唯一標識符（或頻道用戶名，格式為 @channelusername）
• messageId：在 from_chat_id 指定聊天中消息的標識符
• params（可選）：包含可選參數的對象：
  • message_thread_id（可選）：目標消息線程（主題）的唯一標識符（僅限論壇超級群組）
  • video_start_timestamp（可選）：轉發視頻的新起始時間戳
  • disable_notification（可選）：靜默發送消息。用戶將收到無聲音的通知。
  • protect_content（可選）：保護轉發消息的內容，防止被轉發和保存
• 成功返回發送的 Message 對象

📄 許可證

本項目採用 MIT License。

此文檔為 NexusX-MCP/telegram-mcp-server 項目的官方指南。