telegram-mcp

Telegram MCP 服务器

该服务器是 Telegram API 和 AI 助手之间的桥梁，基于模型上下文协议。

重要提示：使用此服务器前，请确保您已阅读并理解Telegram API 服务条款。任何滥用 Telegram API 的行为都可能导致您的帐户被暂停。

目录

• 什么是 MCP？
• 这个服务器是做什么的？
  • 功能
  • 提示示例
    • 消息管理
    • 组织
    • 沟通
• 安装
  • 自制
  • NPX
  • 来自发布
    • MacOS
    • Linux
    • 视窗
  • 来自源
• 配置
  • 授权
  • 客户端配置
• 星史

什么是 MCP？

模型上下文协议 (MCP) 是一个允许 AI 应用（例如 Claude Desktop 或 Cursor）连接到外部工具和数据源的系统。它为 AI 助手提供了一种清晰、安全的方式，使其能够使用本地服务和 API，同时确保用户的控制权。

这个服务器是做什么的？

功能

• [x] 获取当前账户信息（ tool: tg_me ）
• [x] 使用可选的未读过滤器列出对话框（ tool: tg_dialogs ）
• [x] 将对话框标记为已读（ tool: tg_read ）
• [x] 从特定对话框中检索消息（ tool: tg_dialog ）
• [x] 向任意对话框发送草稿消息（ tool: tg_send ）

提示示例

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

消息管理

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

组织

• “分析我的电报对话并建议一个文件夹结构”
• “帮我按重要性对 Telegram 聊天进行分类”
• “查找所有与工作相关的对话并提出组织建议”

沟通

• “监控特定聊天中有关 [主题] 的更新”
• “起草一份对[聊天]中最后一条消息的礼貌回复”
• “检查我的聊天中是否有未回答的问题”

安装

自制

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

NPX

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

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

• 认证命令变为：

• Claude MCP 服务器配置变为：

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

来自发布

MacOS

**注意：**以下命令将安装到/usr/local/bin目录。要安装到其他目录，请将/usr/local/bin替换为 PATH 中你希望安装的目录。

首先，下载适合您的架构的档案：

然后安装二进制文件：

Linux

**注意：**以下命令将安装到/usr/local/bin目录。要安装到其他目录，请将/usr/local/bin替换为 PATH 中你希望安装的目录。

首先，下载适合您的架构的档案：

然后安装二进制文件：

视窗

视窗

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

来自源

要求：

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

配置

授权

在使用服务器之前，您需要连接到 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" } } } }
   对于光标：
   { "mcpServers": { "telegram-mcp": { "command": "telegram-mcp", "env": { "TG_APP_ID": "<your-app-id>", "TG_API_HASH": "<your-api-hash>" } } } }

星史