Hot Trending Mcp

Name: Hot Trending Mcp
Author: LLM Mart

No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.

Real-time hot-search & trending boards from 8 major Chinese platforms in one MCP call — Weibo, Zhihu, Bilibili, Baidu, Toutiao, Douyin, Tieba and Juejin.

Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
Or self-host: a single Python file, stdlib HTTP + FastMCP, zero paid dependencies.

⚡ Use the hosted endpoint (no setup)

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

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop claude_desktop_config.json, Cursor mcp.json, Cline, Cherry Studio, etc.):

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

Clients that do not accept "type": "http" (some Cherry Studio / older Cline versions) accept the same entry with just "url".

🧰 Tools

Tool	Parameters	Returns
`query_hot_trending(platform="all", limit=20)`	`platform`: one of `weibo` / `zhihu` / `bilibili` / `baidu` / `toutiao` / `douyin` / `tieba` / `juejin`, or `all` (default) — returns the top 10 of every board at once. `limit`: items per board for single-platform queries (1–50, default 20).	Each item: `rank`, `title`, `hot` (platform-specific popularity value), `url`. With `all` you get a `platforms` map plus a `failed` map (any degraded source never breaks the others).
`list_platforms()`	—	Returns the 8 supported platform slugs with Chinese and English display names.

📡 Data sources, caching & limits

Weibo weibo.com/ajax/side/hotSearch, Zhihu api.zhihu.com/topstory, Bilibili api.bilibili.com/x/web-interface/popular, Baidu top.baidu.com/api/board, Toutiao toutiao.com/hot-event/hot-board, Douyin iesdouyin.com/web/api/v2/hotsearch/billboard/word, Tieba tieba.baidu.com/hottopic, Juejin api.juejin.cn/content_api/v1/article_rank.
All data comes from each platform's own public web/API endpoints — no API key, no login, no scraping of private data.
Implementation inspired by the open-source DailyHotApi project (MIT) with a thin stdlib-only implementation.
Results are cached in memory for 300 seconds; a failed source degrades gracefully.
The hosted endpoint is rate-limited to 200 requests / minute / IP (HTTP 429 beyond that).

🐢 Self-hosting

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"

Then point your MCP client at http://127.0.0.1:8007/mcp. No API keys or accounts are ever required.

🐳 Self-host with Docker

Option A — pull the pre-built image (fastest, no build):

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

Option B — build from source:

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

Then point your MCP client at http://127.0.0.1:8000/mcp. The container listens on 0.0.0.0:8000 by default (override with -e MCP_PORT=9000 and adjust -p accordingly). No API keys or accounts required.

platform_names.json — Chinese/English display names of the 8 platforms (kept outside the code file so the source stays pure-ASCII).