io.github.FrankXMX/dailyhotmcp

今日热榜

一个聚合热门数据的 MCP 服务

特性

• 支持 MCP 协议，可直接集成到 Claude Desktop、Cursor 等 AI 助手
• 极快响应，便于开发
• 支持 RSS 模式和 JSON 模式
• 支持多种部署方式
• 简明的路由目录，便于新增

快速开始

MCP 使用

本项目发布在 [MCP 注册表](https://modelcontextprotocol.io registry)，支持以下客户端：

OpenClaw

在 OpenClaw 设置中添加 MCP 服务器配置：

{
  "mcpServers": {
    "dailyhot": {
      "command": "npx",
      "args": ["-y", "@frank-x/dailyhot-mcp@latest"]
    }
  }
}

重启后即可对话使用，支持 55+ 平台热门数据查询，如：

获取微博热搜榜前10条数据
获取 B 站热门视频
列出所有可用的平台

OpenCode

在 OpenCode 配置文件 opencode.json 中添加（参考 OpenCode MCP 配置）：

{
  "mcp": {
    "dailyhot": {
      "type": "local",
      "command": ["npx", "-y", "@frank-x/dailyhot-mcp@latest"]
    }
  }
}

HTTP + SSE 模式

支持通过 HTTP 接口访问 MCP 服务。启动 HTTP 服务器后，配置客户端连接：

OpenCode Remote 配置：

{
  "mcp": {
    "dailyhot": {
      "type": "remote",
      "url": "http://localhost:3000/mcp",
      "enabled": true
    }
  }
}

注意：需要先启动 HTTP 服务器（见下文）。

Claude Desktop / Cursor 配置：

{
  "mcpServers": {
    "dailyhot-http": {
      "command": "npx",
      "args": ["-y", "@frank-x/dailyhot-mcp@latest", "--http"],
      "env": {
        "MCP_PORT": "3000"
      }
    }
  }
}

注意：Claude Desktop 默认仅支持 stdio 模式。部分客户端如 MCP Client、Windsurf 或自定义客户端可能支持 HTTP 连接。

启动 HTTP 服务器：

# 启动 HTTP 服务器（默认端口 3000）
npx @frank-x/dailyhot-mcp --http

# 或使用环境变量
MCP_HTTP=1 npx @frank-x/dailyhot-mcp

# 自定义端口
MCP_PORT=8080 npx @frank-x/dailyhot-mcp --http

HTTP 端点：

• POST /mcp - 发送 JSON-RPC 请求
• GET /mcp - SSE 长连接（接收服务端推送）
• GET /health - 健康检查

其他 MCP 客户端

同样配置即可使用。

使用 SDK 连接 HTTP 模式

可以使用 MCP SDK 的 StreamableHTTPClientTransport 连接 HTTP 服务器：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

async function main() {
  const client = new Client(
    {
      name: "dailyhot-client",
      version: "1.0.0",
    },
    {
      capabilities: {},
    }
  );

  await client.connect(
    new StreamableHTTPClientTransport(new URL("http://localhost:3000/mcp"))
  );

  // 调用工具
  const result = await client.callTool({
    name: "weibo",
    arguments: { limit: 10 },
  });

  console.log(result);
}

main();

作为 npm 包使用

pnpm add @frank-x/dailyhot-mcp

import { main } from "@frank-x/dailyhot-mcp";

/**
 * 启动 MCP 服务（stdio 模式）
 * @returns {Promise<void>}
 */
main();

/**
 * 启动 MCP HTTP 服务
 * @param {number} port 端口号，默认 3000
 */
main({ port: 8080 });

MCP 工具说明

所有 MCP 工具支持以下参数：

• limit?: number - 限制返回数量
• noCache?: boolean - 跳过缓存，强制获取最新数据

list_platforms - 获取所有可用平台列表（无参数）

返回数据包含 prompt 字段，指导大模型以友好格式展示结果。

接口总览

项目支持 55+ 平台热门数据，可通过 MCP 工具或 npm 包调用。

MCP 工具

所有平台都作为 MCP 工具注册，可通过 list_platforms 工具获取完整列表。

查看支持的平台

部署

Docker 部署

# 构建
docker build -t dailyhot-mcp .

# 运行
docker run --restart always -p 6688:6688 -d dailyhot-mcp
# 或使用 Docker Compose
docker-compose up -d

手动部署

git clone https://github.com/FrankXMX/dailyhotmcp.git
cd dailyhotmcp
pnpm install

复制 .env.example 为 .env 并修改配置。

开发

pnpm dev

编译运行

pnpm build
pnpm start

pm2 部署

pnpm i pm2 -g
pnpm build
sh ./deploy.sh

须知

• 默认缓存 60 分钟，可在 .env 中修改 CACHE_TTL
• 部分接口使用页面爬虫，若违反对应页面规则请联系移除

免责声明

• 本项目服务仅供技术研究和开发测试使用
• 获取的信息来自公开渠道，不对准确性作出承诺
• 使用本项目产生的法律责任由使用者自行承担

鸣谢

• RSSHub
• DailyHotApi