Telegram MCP服务

电报MCP服务器

该服务器是Telegram API和人工智能助手之间的桥梁，基于 模型上下文协议.

[！重要] 确保您已阅读并理解 电报API服务条款 在使用此服务器之前。 任何对Telegram API的滥用都可能导致您的帐户被暂停。

目录

• 什么是MCP？
• 这个服务器做什么？
  • 能力
  • 提示示例
    • 消息管理
    • 组织
    • 沟通
• 安装
  • 家酿
  • NPX
  • 从发布
    • MacOS
    • Linux
    • 视窗
  • 来源
• 配置
  • 授权
  • 客户端配置
  • JSON架构版本
• 明星历史

什么是MCP？

模型上下文协议（MCP）是一个允许人工智能应用程序（如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聊天进行分类”
• “查找所有与工作相关的对话，并建议如何组织它们”

沟通

• “监视特定聊天以获取有关[topic]的更新”
• “起草对[聊天]中最后一条消息的礼貌回复”
• “检查我的聊天记录中是否有任何未回答的问题”

安装

家酿

您可以使用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>"
      }
    }
  }
}

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

从发布

MacOS

# 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

# 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

视窗

来源

要求：

• 转到1.24或更高版本
• GOBIN在路上

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

配置

授权

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

1. 从获取API ID和哈希 电报API

2. 运行以下命令：

   注： 如果您启用了2FA：添加--密码<2FA_password>

   注： 如果要覆盖现有会话：add--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 Desktop配置文件：

   • 在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>"
         }
       }
     }
   }
   

JSON架构版本

一些MCP客户端（如VS Code）不支持JSON模式草案2020-12，并将拒绝使用它的工具。您可以通过设置 --schema-version 旗帜或 TG_SCHEMA_VERSION 环境变量。

常见值：

明星历史