China Hot Trending MCP

中国热门趋势 MCP

一次 MCP 调用即可获取中国 8 大平台的实时热搜和趋势榜单——微博、知乎、哔哩哔哩、百度、头条、抖音、贴吧和掘金。

• 30 秒即可试用：免费的公共 MCP 端点已在运行——只需将 URL 粘贴到 MCP 客户端中（无需安装，也无需 API 密钥）。
• 也可自行托管：仅需一个 Python 文件，使用标准库 HTTP 和 FastMCP，无需付费依赖。

⚡ 使用托管端点（无需设置）

https://mcp.pianam.cn/hot-mcp/mcp

传输方式：Streamable HTTP（兼容 MCP 2025-03-26）。无需身份验证。

🔌 客户端配置

将以下内容添加到 MCP 客户端的 mcpServers 配置中（Claude Desktop 的 claude_desktop_config.json、Cursor 的 mcp.json、Cline、Cherry Studio 等）：

{
  "mcpServers": {
    "hot-trending": {
      "type": "http",
      "url": "https://mcp.pianam.cn/hot-mcp/mcp"
    }
  }
}

不接受 "type": "http" 的客户端（部分 Cherry Studio / 较旧版本的 Cline）也可使用相同条目，只需保留 "url"。

🧰 工具

工具	参数	返回内容
query_hot_trending(platform="all", limit=20)	platform：可选 weibo / zhihu / bilibili / baidu / toutiao / douyin / tieba / juejin，或 all（默认）——一次性返回每个榜单的前 10 项。 limit：查询单个平台时每个榜单返回的条目数（1–50，默认 20）。	每个条目包含：rank、title、hot（平台特定的热度值）、url。使用 all 时会返回 platforms 映射以及 failed 映射（任何数据源出现故障都不会影响其他数据源）。
list_platforms()	—	返回 8 个受支持的平台标识及其中英文显示名称。

📡 数据源、缓存和限制

• 微博 weibo.com/ajax/side/hotSearch、知乎 api.zhihu.com/topstory、哔哩哔哩 api.bilibili.com/x/web-interface/popular、百度 top.baidu.com/api/board、头条 toutiao.com/hot-event/hot-board、抖音 iesdouyin.com/web/api/v2/hotsearch/billboard/word、贴吧 tieba.baidu.com/hottopic、掘金 api.juejin.cn/content_api/v1/article_rank。
• 所有数据均来自各平台自身的公开网页/API 端点——无需 API 密钥，无需登录，也不抓取私人数据。
• 实现参考了开源项目 DailyHotApi（MIT），并采用精简的纯标准库实现。
• 结果会缓存在内存中 300 秒；数据源故障时会优雅降级。
• 托管端点的速率限制为每个 IP 每分钟 200 次请求（超出后返回 HTTP 429）。

🐢 自行托管

git clone https://github.com/boy-373/hot-trending-mcp.git
cd hot-trending-mcp
pip install -r requirements.txt
python hot_mcp_server.py
# the server listens on 127.0.0.1:8007 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python hot_mcp_server.py
#   MCP_ALLOWED_HOSTS="your-domain.com,127.0.0.1:*"
#   MCP_ALLOWED_ORIGINS="https://your-domain.com"

然后将 MCP 客户端指向 http://127.0.0.1:8007/mcp。 始终无需 API 密钥或账号。

🐳 使用 Docker 自行托管

选项 A——拉取预构建镜像（最快，无需构建）：

docker run -d -p 8000:8000 --name hot-trending-mcp ghcr.io/boy-373/hot-trending-mcp:latest

选项 B——从源代码构建：

git clone https://github.com/boy-373/hot-trending-mcp.git
cd hot-trending-mcp
docker build -t hot-trending-mcp .
docker run -d -p 8000:8000 --name hot-trending-mcp hot-trending-mcp

然后将 MCP 客户端指向 http://127.0.0.1:8000/mcp。 容器默认监听 0.0.0.0:8000（可通过 -e MCP_PORT=9000 覆盖，并相应调整 -p）。无需 API 密钥或账号。

• platform_names.json — 8 个平台的中英文显示名称（与代码文件分开放置，以保持源代码为纯 ASCII）。

🗂️ 文件

• hot_mcp_server.py — MCP 服务（FastMCP，Streamable HTTP 传输）。
• rate_limit.py — 轻量级的按 IP 滑动窗口速率限制中间件（默认每分钟 200 次请求）。
• requirements.txt — mcp、uvicorn、starlette。
• server.json — MCP Registry 官方清单（远程服务条目，可直接使用 mcp-publisher 发布）。
• smithery.yaml / glama.json — 目录列表元数据。

---

🇨🇳 中文使用说明

一句话：一次调用，获取 8 大中文平台热榜：微博热搜、知乎热榜、B站热门、百度热搜、头条热榜、抖音热点、贴吧热议、掘金热榜。数据全部来自各平台官方公开接口，无需任何 API Key 或登录；服务端缓存 5 分钟，单 IP 限流 200 次/分钟。

在线直连地址（免费、无需 Key、开箱即用）：https://mcp.pianam.cn/hot-mcp/mcp

在 MCP 客户端（Claude Desktop / Cursor / Cherry Studio / Cline 等）的配置里加入：

{
  "mcpServers": {
    "hot-trending": {
      "type": "http",
      "url": "https://mcp.pianam.cn/hot-mcp/mcp"
    }
  }
}

工具：

• query_hot_trending(platform, limit)：一次调用获取 8 大平台热榜。platform 传 all（默认）时返回每个平台 Top10；也可传入单个平台 slug（weibo/zhihu/bilibili/baidu/toutiao/douyin/tieba/juejin），limit 控制条数（1-50）。
• list_platforms()：列出支持的 8 个平台及其中英文名称。
• 返回字段：排名 rank、标题 title、热度值 hot、原文链接 url；all 模式还会返回 failed 字段，标注暂时失败的平台，不影响其他平台。

服务特性：数据源全部为公开接口，无需注册或付费；服务端内存缓存，失败时自动降级或切换备用通道；单 IP 限流 200 次/分钟。

本地部署：

git clone https://github.com/boy-373/hot-trending-mcp.git
cd hot-trending-mcp
pip install -r requirements.txt
python hot_mcp_server.py
# 默认监听 127.0.0.1:8007，可用环境变量 MCP_HOST / MCP_PORT / MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS 覆盖

Docker 自托管：

# 方式一：直接拉预构建镜像（最快，无需构建）
docker run -d -p 8000:8000 --name hot-trending-mcp ghcr.io/boy-373/hot-trending-mcp:latest

# 方式二：从源码构建
git clone https://github.com/boy-373/hot-trending-mcp.git && cd hot-trending-mcp
docker build -t hot-trending-mcp .
docker run -d -p 8000:8000 --name hot-trending-mcp hot-trending-mcp
# MCP 地址填：http://127.0.0.1:8000/mcp

容器默认监听 0.0.0.0:8000（可用 -e MCP_PORT=端口 修改），无需任何 API Key 或账号。

📄 许可证

MIT © 2026 boy-373

通过 Smithery 安装

一键安装到支持 Smithery 的客户端（Claude Desktop、Cursor 等）：

或者运行：

npx -y @smithery/cli install 1561852680/hot-trending-mcp --client claude

---

🔌 通过任意 AI 客户端使用——一键 MCP 网关

我们托管了一个免费的 MCP 聚合网关：你的 AI 助手（Cherry Studio、Claude Desktop、Cursor、Cline——任何 MCP 客户端）都可以通过一个 URL 发现并使用 MCP 工具：

https://mcp.pianam.cn/ai/mcp

添加一次后，就可以用自然语言交流——AI 会自动搜索 → 检查 → 调用合适的 MCP。

• 🔍 搜索 22,000+ 个已索引的 MCP 服务（中文和英文）
• ⚡ 50+ 个在线托管的 MCP 服务可直接调用、开箱即用（天气、汇率、热榜、IP 地理位置、火车票……）
• 📦 基于 GitHub 的 MCP 服务：搜索结果会提供链接，方便在本地安装
• ✅ 每周检查服务运行状况，正常运行的服务会排在前面
• 🆓 免费使用，无需密钥

📖 3 步配置指南 / 中文接入教程：https://mcp.pianam.cn/ai-gateway