在人工智能日益融入我们数字生活的今天，能够让 AI 助手与我们常用的应用无缝协作变得至关重要。telegram-mcp 就是这样一款由开发者 chaindead 创建的强大工具，它充当了 Telegram API 与 AI 助手之间的桥梁，让您能够以前所未有的方式管理和自动化您的 Telegram 体验。

什么是 MCP？

在我们深入了解 telegram-mcp 之前，先简单介绍一下模型上下文协议 (Model Context Protocol, MCP)。MCP 是一个旨在让 AI 应用程序（如 Claude Desktop 或 Cursor 等）能够安全、清晰地连接到外部工具和数据源的系统。它赋予了 AI 助手与本地服务和 API 交互的能力，同时确保用户对数据和操作拥有完全的控制权。

telegram-mcp：您的 Telegram AI 管家

telegram-mcp 服务器利用 MCP 协议，将 Telegram 的强大功能暴露给 AI 助手。这意味着您可以指示您的 AI 助手来执行各种 Telegram 操作，从消息管理到通信自动化。

核心功能概览：

  • 账户信息查询 (tg_me): 获取当前登录的 Telegram 账户的详细信息。
  • 对话列表与筛选 (tg_dialogs): 列出您的所有对话，并能根据未读状态进行筛选，助您快速定位重要信息。
  • 标记已读 (tg_read): 轻松将指定的对话标记为已读，保持收件箱的整洁。
  • 对话消息检索 (tg_dialog): 从特定的对话中提取消息历史，方便 AI 进行分析或回顾。
  • 发送草稿 (tg_send): 允许 AI 助手为您在任何对话中准备并发送草稿消息。

如何安装和配置 telegram-mcp

1. 安装

您可以根据您的操作系统和偏好选择多种安装方式：

  • Homebrew (macOS/Linux): # 安装 brew install chaindead/tap/telegram-mcp # 更新 brew upgrade chaindead/tap/telegram-mcp
  • NPX (跨平台):
    直接运行最新版本，无需安装： npx -y @chaindead/telegram-mcp 使用 NPX 时，后续的授权和客户端配置命令需要相应调整（例如，授权命令变为 npx -y @chaindead/telegram-mcp auth ...）。
  • 从 Releases 下载 (MacOS, Linux, Windows):
    前往项目的 GitHub Releases 页面 下载对应您系统的预编译二进制文件压缩包，解压后将可执行文件放置到您的系统路径 (PATH) 下。
  • 从源码编译:
    如果您安装了 Go (1.24+) 环境并且 GOBIN 在您的 PATH 中：
    bash go install github.com/chaindead/telegram-mcp@latest

2. 授权 telegram-mcp 连接 Telegram

在使用服务器之前，您需要授权它连接到您的 Telegram 账户：

  1. 获取 API 凭证: 前往 Telegram API 官方网站 登录并获取您的 API ID 和 API Hash。
  2. 运行授权命令: bash telegram-mcp auth --app-id <你的API_ID> --api-hash <你的API_HASH> --phone <你的电话号码>
    • 如果您的账户启用了两步验证 (2FA)，请附加 --password <你的2FA密码>。
    • 如果需要覆盖现有会话，请附加 --new。
  3. 输入验证码: Telegram 会向您的账户发送一个验证码，在命令行中输入该验证码即可完成授权。

3. 配置 AI 助手客户端

以 Claude Desktop 为例，配置其识别 telegram-mcp 服务器：

  1. 打开配置文件:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
      （您也可以在 Claude Desktop 应用的设置中找到此文件）
  2. 添加服务器配置:

    注意:
    • 请将尖括号中的占位符替换为您的实际信息。
    • 如果使用 NPX，command 应为 npx，并添加 args 字段。PATH 和 HOME 可能不再严格需要，但保留 API ID/Hash 环境变量是好的。
    • 确保 telegram-mcp 可执行文件位于您系统的 PATH 环境变量中，或者在 env 中的 PATH 字段明确指定其所在目录。
{
  "mcpServers": {
    "telegram": { // 或 "telegram-mcp" 用于 Cursor 等其他客户端
      "command": "telegram-mcp", // 如果使用 NPX，这里是 "npx"
      // "args": ["-y", "@chaindead/telegram-mcp"], // 仅当 command 为 "npx" 时需要
      "env": {
        "TG_APP_ID": "<你的API_ID>",
        "TG_API_HASH": "<你的API_HASH>",
        // 对于非 NPX 安装，确保 telegram-mcp 在 PATH 中，或在此处指定包含二进制文件的路径
        "PATH": "<包含telegram-mcp二进制文件的目录路径>", // 例如 "/usr/local/bin" 或 "C:\\path\\to\\binary"
        "HOME": "<您的用户主目录路径>" // 例如 "/Users/yourname" 或 "C:\\Users\\yourname"
      }
    }
  }
}

实用指令示例：让 AI 动起来

配置完成后，您就可以开始通过 AI 助手与 Telegram 互动了：

  • 消息管理:
    • “帮我检查一下 Telegram 上有没有重要的未读消息。”
    • “总结一下我所有的 Telegram 未读消息。”
    • “阅读并分析我的未读消息，并在需要时准备回复草稿。”
  • 组织与分类:
    • “分析我的 Telegram 对话，并建议一个文件夹结构。”
    • “帮我按重要性对 Telegram 聊天进行分类。”
  • 通信与自动化:
    • “监控 [某个聊天名称] 中关于 [某个主题] 的更新。”
    • “为 [某个聊天名称] 中的最后一条消息起草一个礼貌的回复。”
    • “检查我的聊天记录中是否有任何未解答的问题。”

重要提示

请务必阅读并遵守 Telegram API 服务条款。任何对 Telegram API 的不当使用都可能导致您的账户被暂停。

结语

telegram-mcp 服务器为我们打开了一扇全新的大门，让强大的 AI 助手能够深入到我们的日常通信工具中，提供前所未有的便捷和效率。无论是个人用户希望更智能地管理消息，还是开发者寻求构建更高级的 Telegram 自动化工具，telegram-mcp 都提供了一个坚实的基础。

不妨现在就去 chaindead/telegram-mcp GitHub 仓库 给它一个 ⭐，并开始探索 AI 增强的 Telegram 新体验吧！