Telegram MCP 服务器

服务器是Telegram API和AI助手之间的桥梁,基于 示范背景协议。 。 。 .

[大 确保您阅读和理解 API 服务条款 在使用此服务器之前 . 任何滥用Telegram API的行为都可能导致您的账户被中止.

目录

• 什么是MCP吗?
• 这个服务器是做什么的?
  • 能力
  • 提示示例
    • 信件管理
    • 组织
    • 通讯
• 安装
  • 土生土长
  • 国家PX
  • 从发行
    • 麦克OS
    • 链接
    • 窗口
  • 从源
• 配置
  • 授权
  • 客户端配置
  • JSON 舍马版本
• 恒星历史

什么是MCP吗?

模式上下文协议(MCP)是一个允许AI应用的系统,如克洛德桌面或光标,连接到外部工具和数据源. 它为AI助手在保持用户控制的同时与本地服务和API合作提供了明确而安全的方法.

这个服务器是做什么的?

能力

• 获取经常账户信息( E)tool: tg_me(中文(简体) )
• 列出带有可选的未读过滤器的对话框( L)tool: tg_dialogs(中文(简体) )
• 将对话框标为已读( R)tool: tg_read(中文(简体) )
• 从特定对话框获取信件( E)tool: tg_dialog(中文(简体) )
• 向任何对话框发送信件草稿 (S)tool: tg_send(中文(简体) )

提示示例

这里有一些示例提示, 您可以使用 AI 助手 :

信件管理

• "检查我电报中任何未读到的重要消息"
• "解析我所有未读的电报"
• "阅读和分析我未读到的信息, 必要时编写答复草案"
• "检查非批判的未读消息,给我一个简要的概述"

组织

• 分析我的Telegram 对话框并推荐文件夹结构
• "帮我按重要性来分类我的Telegram聊天"
• "寻找所有与工作有关的谈话,并建议如何组织对话"

通讯

• "监视器特定聊天 关于[专题]的更新"
• "对[聊天]中最后一条消息的礼貌回应草案"
• "看看我聊天时有没有问题没有答案"

安装

土生土长

您可以使用酿酒在 macOS/ Linux 上安装二进制放出 :

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

国家PX

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

完整的设置说明见 授权 财务报告和审定财务报表 客户端配置。 。 。 .

从发行

麦克OS

# 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

链接

# 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 : 添加 -- password < 2fa password >

   说明: 如果您想要覆盖已有会话: 添加 -- new

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   

   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. 添加服务器配置

   用于克洛德桌面 :

    {
      "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代码)不支持JSON Schema Draft 2020-12,并将拒绝使用它的工具. 您可以通过设置 JSON Schema 版本来覆盖 --schema-version 旗帜或 TG_SCHEMA_VERSION 环境变量.

共同价值:

恒星历史