Telegram MCP 服务器

该服务器是 Telegram API 与 AI 助手之间的桥梁，基于 Model Context Protocol (MCP)。

[!IMPORTANT]
在使用此服务器之前，请确保您已阅读并理解 Telegram API 服务条款。
任何对 Telegram API 的滥用都可能导致您的账户被暂停。

目录

• 什么是 MCP？
• 这个服务器做什么？
  • 功能
  • 提示示例
    • 消息管理
    • 组织
    • 通信
• 安装
  • Homebrew
  • NPX
  • 从发行版
    • MacOS
    • Linux
    • Windows
  • 从源代码
• 配置
  • 授权
  • 客户端配置
• 星标历史

什么是 MCP？

Model Context Protocol (MCP) 是一个系统，它允许像 Claude Desktop 或 Cursor 这样的 AI 应用程序连接到外部工具和数据源。它为 AI 助手提供了清晰且安全的方式来与本地服务和 API 交互，同时保持用户的控制权。

这个服务器做什么？

功能

• 获取当前账户信息 (tool: tg_me)
• 列出对话（可选未读过滤）(tool: tg_dialogs)
• 标记对话为已读 (tool: tg_read)
• 从特定对话中检索消息 (tool: tg_dialog)
• 将草稿消息发送到任意对话 (tool: tg_send)

提示示例

以下是一些您可以与 AI 助手使用的示例提示：

消息管理

• "检查我的 Telegram 中是否有任何未读的重要消息"
• "总结所有我未读的 Telegram 消息"
• "阅读并分析我的未读消息，并在需要时准备草稿回复"
• "检查非关键的未读消息，并给我一个简要概述"

组织

• "分析我的 Telegram 对话并建议文件夹结构"
• "帮助我按重要性分类我的 Telegram 聊天"
• "找到所有与工作相关的对话，并建议如何组织它们"

通信

• "监控特定聊天中的 [话题] 更新"
• "为 [聊天] 中的最后一条消息起草一个礼貌的回复"
• "检查我的聊天中是否有任何未回答的问题"

安装

Homebrew

您可以使用 brew 在 macOS/Linux 上安装二进制发行版：

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

您可以直接使用 npx 运行最新版本（支持 macOS、Linux 和 Windows）：

npx -y @chaindead/telegram-mcp

当使用 NPX 时，修改标准命令和配置如下：

• 认证命令 变为：

npx -y @chaindead/telegram-mcp auth ...

• Claude MCP 服务器配置 变为：

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

完整的设置说明，请参阅 授权 和 客户端配置。

从 Releases 安装

MacOS

注意： 下面的命令会安装到 /usr/local/bin。如果您希望安装到其他位置，请将 /usr/local/bin 替换为您 PATH 中的首选目录。

首先，下载适合您架构的归档文件：

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

然后安装二进制文件：

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

注意： 下面的命令会安装到 /usr/local/bin。如果您希望安装到其他位置，请将 /usr/local/bin 替换为您 PATH 中的首选目录。

首先，下载适合您架构的归档文件：

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

然后安装二进制文件：

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Windows

Windows

1. 下载适合您架构的最新版本：
   • Windows x64
   • Windows ARM64
2. 解压 .zip 文件
3. 将解压后的目录添加到您的 PATH 中，或将 telegram-mcp.exe 移动到您的 PATH 中的一个目录

从源代码编译

要求：

• Go 1.24 或更高版本
• GOBIN 在 PATH 中

go install github.com/chaindead/telegram-mcp@latest

配置

授权

在使用服务器之前，您需要连接到 Telegram API。

1. 从 Telegram API 获取 API ID 和哈希。

2. 运行以下命令：

   注意：
   如果启用了 2FA：添加 --password <2fa_password>

   注意：
   如果要覆盖现有会话：添加 --new

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   

   📩 输入从 Telegram 收到的验证码以连接到 API。

3. 完成！请给这个项目一个 ⭐️ 来支持其开发。

客户端配置

配置 Claude Desktop 以识别 Telegram MCP 服务器的示例。

1. 打开 Claude 桌面配置文件：

   • 在 MacOS 中，配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 中，配置文件位于 %APPDATA%\Claude\claude_desktop_config.json

   注意:
   你也可以在 Claude Desktop 应用的设置中找到 claude_desktop_config.json

2. 添加服务器配置

   对于 Claude 桌面版:

    {
      "mcpServers": {
        "telegram": {
          "command": "telegram-mcp",
          "env": {
            "TG_APP_ID": "<your-app-id>",
            "TG_API_HASH": "<your-api-hash>",
            "PATH": "<path_to_telegram-mcp_binary_dir>",
            "HOME": "<path_to_your_home_directory"
          }
        }
      }
    }
   

   对于 Cursor:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "env": {
           "TG_APP_ID": "<your-app-id>",
           "TG_API_HASH": "<your-api-hash>"
         }
       }
     }
   }
   

Star History