项目介绍
Telegram MCP 服务器
该服务器是 Telegram API 和 AI 助手之间的桥梁，并基于 模型上下文协议。
[!IMPORTANT] 在使用此服务器之前，请确保您已阅读并理解了 Telegram API 使用条款。 对 Telegram API 的任何滥用都可能导致您的账户被暂停。
目录
什么是 MCP？
模型上下文协议（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
您可以在 macOS/Linux 上使用 brew 安装二进制发布版：
# 安装
brew install chaindead/tap/telegram-mcp
# 更新
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>"
}
}
}
}
从发布版安装
MacOS
<details>注意： 下面的命令会安装到
/usr/local/bin。如果您想安装到其他位置，请将/usr/local/bin替换为您 PATH 中的首选目录。
首先，下载适合您架构的存档：
# 对于 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
# 对于 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
然后安装二进制文件：
# 解压二进制文件
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin
# 设置可执行权限
sudo chmod +x /usr/local/bin/telegram-mcp
# 清理
rm telegram-mcp.tar.gz
Linux
<details>注意： 下面的命令会安装到
/usr/local/bin。如果您想安装到其他位置，请将/usr/local/bin替换为您 PATH 中的首选目录。
首先，下载适合您架构的存档：
# 对于 x86_64 (64位)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz
# 对于 ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/-dead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz
然后安装二进制文件：
# 解压二进制文件
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin
# 设置可执行权限
sudo chmod +x /usr/local/bin/telegram-mcp
# 清理
rm telegram-mcp.tar.gz
Windows
<details>Windows
- 下载适合您架构的最新版本：
- 解压
.zip文件 - 将解压的目录添加到您的 PATH 中，或移动
telegram-mcp.exe到 PATH 中的一个目录
从源码安装
需求：
- Go 1.24 或更高版本
- GOBIN 在 PATH 中
go install github.com/chaindead/telegram-mcp@latest
配置
授权
在您能够使用服务器之前，您需要连接到 Telegram API。
-
从 Telegram API 获取 API ID 和哈希值
-
运行以下命令：
注意： 如果您启用了双重验证：添加 --password <2fa_password>
注意： 如果您想要覆盖现有会话：添加 --new
telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>📩 输入您从 Telegram 收到的验证码以连接到 API。
-
完成！请给这个项目一个 ⭐️ 来支持其发展。
客户端配置
配置 Claude Desktop 以识别 Telegram MCP 服务器的示例。
-
打开 Claude Desktop 配置文件：
- 在 MacOS 中，配置文件位于
~/Library/Application Support/Claude/claude_desktop_config.json - 在 Windows 中，配置文件位于
%APPDATA%\Claude\claude_desktop_config.json
注意： 您也可以在 Claude Desktop 应用程序的设置中找到 claude_desktop_config.json
- 在 MacOS 中，配置文件位于
-
添加服务器配置
对于 Claude desktop：
{ "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>" } } } }