MCP 服务器

telegram-mcp

用于访问用户数据、管理对话（聊天、频道、群组）、检索消息和处理已读状态的 Telegram API 集成。

README

Visitors

Telegram MCP 服务器

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

[!IMPORTANT] 在使用此服务器之前，请确保您已阅读并理解 Telegram API 服务条款。任何滥用 Telegram API 的行为都可能导致您的帐户被暂停。

什么是 MCP？

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

此服务器的作用？

[x] 获取当前用户数据
[x] 获取对话列表（聊天、频道、群组）
[x] 获取给定对话中的消息列表
[x] 草拟消息
[ ] 将频道标记为已读
[ ] 按日期和时间检索消息
[ ] 获取联系人列表

安装

从 Releases 安装

macOS

注意： 上面的命令安装到 /usr/local/bin。要安装到其他位置，请将 /usr/local/bin 替换为您 PATH 中首选的目录。

# Intel Mac (x86_64)
curl -L https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz | tar xz -C /usr/local/bin

# Apple Silicon (M1/M2)
curl -L https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz | tar xz -C /usr/local/bin

Linux

注意： 这些命令安装到 /usr/local/bin。要安装到其他位置，请将 /usr/local/bin 替换为您 PATH 中首选的目录。

# x86_64 (64-bit)
curl -L https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz | tar xz -C /usr/local/bin

# ARM64
curl -L https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz | tar xz -C /usr/local/bin

Windows

下载适用于您的架构的最新版本：
- Windows x64
- Windows ARM64
解压 .zip 文件
将解压后的目录添加到您的 PATH，或将 telegram-mcp.exe 移动到 PATH 中的目录

从源码安装

要求：

Go 1.24 或更高版本
GOBIN 在 PATH 中

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

配置

Telegram API 配置

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

从 Telegram API 获取 API ID 和 hash。
运行以下命令：

注意: 如果您启用了 2FA：添加 --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

添加服务器配置

对于 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>"
      }
    }
  }
}