# @chaindead/telegram-mcp\_linux\_amd64 中文文档 规范地址：https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/ 版本：0\.2\.0 npm 元数据更新时间：2026-02-27T21:37:29.708Z 中文译文更新时间：2026-11-09T19:27:40.773Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chaindead/telegram-mcp_linux_amd64 原文对照：https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：37.2 MB，4 个文件 - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2025-04-08T19:06:13.230Z - 最新版本发布：2026-02-27T21:37:29.571Z - 近 30 天下载量：1793（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：5（近 12 个月 1 个） ## 中文简介 使用API集成的Telegram MCP服务器,用于访问用户数据,管理对话框(聊天,频道,组),检索消息,并处理已读状态. ## 安装 ```sh npm install @chaindead/telegram-mcp_linux_amd64 ``` 也可以使用：`pnpm add @chaindead/telegram-mcp_linux_amd64`、`yarn add @chaindead/telegram-mcp_linux_amd64`、`bun add @chaindead/telegram-mcp_linux_amd64` ## README [![](https://badge.mcpx.dev/?type=server "MCP Server")](https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#communication) [![](https://img.shields.io/badge/OS_Agnostic-Works_Everywhere-purple)](https://github.com/chaindead/telegram-mcp?tab=readme-ov-file#installation) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftelegram-mcp&label=Visitors&labelColor=%23d9e3f0&countColor=%23697689&style=flat&labelStyle=none)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftelegram-mcp) # Telegram MCP 服务器 服务器是Telegram API和AI助手之间的桥梁,基于 [示范背景协议](https://modelcontextprotocol.io/)。 。 。 . > \[大 确保您阅读和理解 [API 服务条款](https://core.telegram.org/api/terms) 在使用此服务器之前 . 任何滥用Telegram API的行为都可能导致您的账户被中止. ## 目录 - [什么是MCP吗?](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-what-is-mcp) - [这个服务器是做什么的?](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-what-does-this-server-do) - [能力](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-capabilities) - [提示示例](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-prompt-examples) - [信件管理](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-message-management) - [组织](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-organization) - [通讯](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-communication) - [安装](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-installation) - [土生土长](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-homebrew) - [国家PX](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-npx) - [从发行](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-from-releases) - [麦克OS](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-macos) - [链接](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-linux) - [窗口](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-windows) - [从源](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-from-source) - [配置](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-configuration) - [授权](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-authorization) - [客户端配置](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-client-configuration) - [JSON 舍马版本](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-json-schema-version) - [恒星历史](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-star-history) ## 什么是MCP吗? 模式上下文协议(MCP)是一个允许AI应用的系统,如克洛德桌面或光标,连接到外部工具和数据源. 它为AI助手在保持用户控制的同时与本地服务和API合作提供了明确而安全的方法. ## 这个服务器是做什么的? ### 能力 - [x] 获取经常账户信息( E)`tool: tg_me`(中文(简体) ) - [x] 列出带有可选的未读过滤器的对话框( L)`tool: tg_dialogs`(中文(简体) ) - [x] 将对话框标为已读( R)`tool: tg_read`(中文(简体) ) - [x] 从特定对话框获取信件( E)`tool: tg_dialog`(中文(简体) ) - [x] 向任何对话框发送信件草稿 (S)`tool: tg_send`(中文(简体) ) ### 提示示例 这里有一些示例提示, 您可以使用 AI 助手 : #### 信件管理 - "检查我电报中任何未读到的重要消息" - "解析我所有未读的电报" - "阅读和分析我未读到的信息, 必要时编写答复草案" - "检查非批判的未读消息,给我一个简要的概述" #### 组织 - 分析我的Telegram 对话框并推荐文件夹结构 - "帮我按重要性来分类我的Telegram聊天" - "寻找所有与工作有关的谈话,并建议如何组织对话" #### 通讯 - "监视器特定聊天 关于\[专题\]的更新" - "对\[聊天\]中最后一条消息的礼貌回应草案" - "看看我聊天时有没有问题没有答案" ## 安装 ### 土生土长 您可以使用酿酒在 macOS/ Linux 上安装二进制放出 : ```bash # Install brew install chaindead/tap/telegram-mcp # Update brew upgrade chaindead/tap/telegram-mcp ``` ### 国家PX 您可以直接使用 npx( 支持 macOS、 Linux 和 Windows) 运行最新版本 : ```bash npx -y @chaindead/telegram-mcp ``` 在使用NPX时,将标准命令和配置修改如下: - [认证命令](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-authorization) 改为: ```bash npx -y @chaindead/telegram-mcp auth ... ``` - [Claude MCP 服务器配置](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-client-configuration) 改为: ```json { "mcpServers": { "telegram": { "command": "npx", "args": ["-y", "@chaindead/telegram-mcp"], "env": { "TG_APP_ID": "", "TG_API_HASH": "" } } } } ``` 完整的设置说明见 [授权](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-authorization) 财务报告和审定财务报表 [客户端配置](https://npmcn.com/package/%40chaindead/telegram-mcp_linux_amd64/#readme-client-configuration)。 。 。 . ### 从发行 #### 麦克OS > **说明:** 以下命令安装到 `/usr/local/bin`。要安装到其他地方,请替换 `/usr/local/bin` 与您的首选目录在您的路径. 首先,下载您的架构存档 : ```bash # 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 ``` 然后安装二进制 : ```bash # 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 ``` #### 链接 > **说明:** 以下命令安装到 `/usr/local/bin`。要安装到其他地方,请替换 `/usr/local/bin` 与您的首选目录在您的路径. 首先,下载您的架构存档 : ```bash # 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 ``` 然后安装二进制 : ```bash # 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 ``` #### 窗口 #### 窗口 1. 下载您架构的最新版本 : - [视窗 x64](https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Windows_x86_64.zip) - [窗口 ARM64](https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Windows_arm64.zip) 2. 提取 `.zip` 文件 3. 将提取的目录添加到您的路径或移动 `telegram-mcp.exe` 到您路径中的目录 ### 从源 所需经费: - 走1.24号或以后 - GOBIN 在路径 ```bash go install github.com/chaindead/telegram-mcp@latest ``` ## 配置 ### 授权 在使用服务器之前,需要连接到Telegram API. 1. 获取 API ID 和散列从 [电报 API](https://my.telegram.org/auth) 2. 运行以下命令 : > **说明:** 如果您启用了 2FA : 添加 -- password < 2fa password > > **说明:** 如果您想要覆盖已有会话: 添加 -- new ```bash telegram-mcp auth --app-id --api-hash --phone ``` QQ 输入您从 Telegram 得到的连接到 API 的代码 . 3. 没问题! 请给这个项目一个 支持它的发展. ### 客户端配置 配置克洛德桌面以识别Telegram MCP服务器的例子. 1. 打开 Claude 桌面配置文件 : - 在MacOS中,配置文件位于 `~/Library/Application Support/Claude/claude_desktop_config.json` - 在 Windows 中,配置文件位于 `%APPDATA%\Claude\claude_desktop_config.json` > **说明:** 您可以在 Claude 桌面应用程序的设置中找到 Claude desktop config.json 2. 添加服务器配置 用于克洛德桌面 : ```json { "mcpServers": { "telegram": { "command": "telegram-mcp", "env": { "TG_APP_ID": "", "TG_API_HASH": "", "PATH": "", "HOME": "", "TG_API_HASH": "" } } } } ``` ### JSON 舍马版本 一些MCP客户端(如VS代码)不支持JSON Schema Draft 2020-12,并将拒绝使用它的工具. 您可以通过设置 JSON Schema 版本来覆盖 `--schema-version` 旗帜或 `TG_SCHEMA_VERSION` 环境变量. 共同价值: | 版本 | 網址 | | --- | --- | | 草案07(为VS码推荐) | `https://json-schema.org/draft-07/schema#` | | 2020-12(违约)草案 | `https://json-schema.org/draft/2020-12/schema` | ## 恒星历史 [![Star History Chart](https://api.star-history.com/svg?repos=chaindead/telegram-mcp&type=Date)](https://www.star-history.com/#chaindead/telegram-mcp&Date) ## 常见问题 ### @chaindead/telegram-mcp\_linux\_amd64 是什么？ 使用API集成的Telegram MCP服务器,用于访问用户数据,管理对话框\(聊天,频道,组\),检索消息,并处理已读状态\. ### 如何安装 @chaindead/telegram-mcp\_linux\_amd64？ 在项目目录运行 npm install @chaindead/telegram-mcp\_linux\_amd64，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 telegram-mcp\_linux\_amd64，可以用 npx telegram-mcp\_linux\_amd64 直接运行。 ### @chaindead/telegram-mcp\_linux\_amd64 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chaindead\_\_telegram-mcp\_linux\_amd64 是否存在。 ### @chaindead/telegram-mcp\_linux\_amd64 可以商用吗？ @chaindead/telegram-mcp\_linux\_amd64 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @chaindead/telegram-mcp\_linux\_amd64 的下载量有多少？ 根据 npm 官方下载统计，@chaindead/telegram-mcp\_linux\_amd64 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,793 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chaindead/telegram-mcp\_linux\_amd64 还在维护吗？ 最新版本 0\.2\.0 发布于 2026/02/28（8 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/04/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。