mcpField
T
tgatlas

tgatlas

本地服务
tgatlas.org社交媒体16 周前更新
代码仓库访问官网

关于 tgatlas

tgatlas 是面向 Agent 和客户端的 Telegram 公开频道 MCP 服务，提供频道资料、发帖频率、Telegram 相似频道推荐和全局搜索。

主要功能

  1. 01频道资料与发帖频率
  2. 02Telegram 相似频道推荐
  3. 03搜索公开频道和群组
  4. 04Markdown 或 JSON 输出

适用场景

  1. 01检查频道是否仍在活跃
  2. 02发现受众相近的频道
  3. 03搜索公开频道

MCP 相关

向 MCP 客户端提供 Telegram 频道查询、相似频道发现和搜索工具。仅读取公开资料，不读取消息、成员列表或私人群组。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "starnikovoleg-tgatlas": {
      "command": "npx",
      "args": [
        "-y",
        "tgatlas-mcp"
      ],
      "env": {
        "TELEGRAM_API_KEY": "<TELEGRAM_API_KEY>",
        "TELEGRAM_API_HOST": "<TELEGRAM_API_HOST>"
      }
    }
  }
}
启动命令npx -y tgatlas-mcp
需要配置的环境变量
TELEGRAM_API_KEY密钥RapidAPI key for telegram155.p.rapidapi.com. Free tier available.
TELEGRAM_API_HOSTUpstream host. Defaults to telegram155.p.rapidapi.com.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtgatlas-mcp0.1.2

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
formatenum否输出格式。"markdown" 是便于模型阅读的精简文本；"json" 是原始 API 响应。默认值为 "markdown"。markdown | json
cadenceboolean否包含发帖频率和最后一条帖子的日期。需要额外调用一次 API。默认值为 true。
channelstring是公开频道：@handle、纯 handle 或 t.me 链接。无法读取私有频道。

详细介绍

README 配图

tgatlas-mcp

适用于公开 Telegram 频道的 MCP 服务。为 Agent 提供频道的真实资料——订阅者数量、描述、创建日期、认证和诈骗标记、发帖频率，以及 Telegram 自身认为与之相似的频道。

无需电话号码、会话文件，也无需维持 MTProto 客户端运行。只需 API 密钥和 Node 运行时。

安装

npx tgatlas-mcp

Claude Desktop / Claude Code / 任意 MCP 客户端：

{
  "mcpServers": {
    "tgatlas": {
      "command": "npx",
      "args": ["-y", "tgatlas-mcp"],
      "env": { "TELEGRAM_API_KEY": "your-rapidapi-key" }
    }
  }
}

在 rapidapi.com/starnikovoleg/api/telegram155 获取密钥。提供免费套餐，无需银行卡。

工具

telegram_channel

频道资料：标题、描述、精确订阅者数量、创建日期、Telegram 自身的认证和诈骗标记，以及发帖频率。

发帖频率是大多数目录遗漏的部分，而它通常正是问题的答案。一个拥有 200,000 名订阅者、但十四个月没有发布任何内容的频道，在只显示关注者数量的列表中，看起来和活跃频道毫无区别。

@durov — Du rov's Channel
Subscribers   1,400,000
Created       2017-02-15
Last post     2026-08-29
Posting rate  0.4 posts/day over the last 30
telegram_similar_channels

Telegram 会将这些频道与指定频道一同推荐——依据的是 Telegram 自身对主题的判断，而非关键词匹配，因此返回的频道受众相同，但用词未必相同。

通过这种方式，你可以找到原本不知道名称的频道：从一个你知道的频道开始，向外扩展。从几十个种子频道出发，扩展两轮即可覆盖数千个频道。

设置 enrich: true 可获取每个结果的精确订阅者数量。

telegram_search_channels

Telegram 对公开频道和群组的全局搜索。用它寻找起点，再用 telegram_similar_channels 扩展。

输出

默认输出 Markdown——模型无需解析即可读取。传入 format: "json"，即可获取原始 API 响应，以便通过管道传入代码。

范围

仅限公开频道元数据。消息内容、成员列表和私人群组不在读取范围内，也不会返回。

费用

工具直接调用 REST 端点，而非代理远程 MCP 端点。RapidAPI 按请求计费，因此 initialize 和 tools/list 免费：只需为查询付费，无需为握手付费。

telegram_channel 在启用发帖频率时需要调用三次，设置 cadence: false 时需要调用两次。telegram_similar_channels 需要调用两次；设置 enrich: true 时，每个结果还需调用一次（最多 12 个）。

环境变量

变量默认值用途
TELEGRAM_API_KEY—RapidAPI 密钥。也支持 RAPIDAPI_KEY。
TELEGRAM_API_HOSTtelegram155.p.rapidapi.com上游主机。
TELEGRAM_TIMEOUT_MS30000每次请求的超时时间。

相关项目

TgAtlas 基于同一 API 发布每周测量数据集：按主题分类的频道目录、反向整理的推荐关系图（“谁推荐了这个频道”），以及这些数据每周的变化情况。

MIT。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。