## 特性
- 支持 MCP 协议，可直接集成到 Claude Desktop、Cursor 等 AI 助手
- 极快响应，便于开发
- 支持 RSS 模式和 JSON 模式
- 支持多种部署方式
- 简明的路由目录，便于新增
## 快速开始
### MCP 使用
本项目发布在 [MCP 注册表](https://modelcontextprotocol.io registry)，支持以下客户端：
#### OpenClaw
在 OpenClaw 设置中添加 MCP 服务器配置：
```json
{
"mcpServers": {
"dailyhot": {
"command": "npx",
"args": ["-y", "@frank-x/dailyhot-mcp@latest"]
}
}
}
```
重启后即可对话使用，支持 55+ 平台热门数据查询，如：
```
获取微博热搜榜前10条数据
获取 B 站热门视频
列出所有可用的平台
```
#### OpenCode
在 OpenCode 配置文件 `opencode.json` 中添加（参考 [OpenCode MCP 配置](https://opencode.ai/docs/zh-cn/mcp-servers/)）：
```json
{
"mcp": {
"dailyhot": {
"type": "local",
"command": ["npx", "-y", "@frank-x/dailyhot-mcp@latest"]
}
}
}
```
#### HTTP + SSE 模式
支持通过 HTTP 接口访问 MCP 服务。启动 HTTP 服务器后，配置客户端连接：
**OpenCode Remote 配置**：
```json
{
"mcp": {
"dailyhot": {
"type": "remote",
"url": "http://localhost:3000/mcp",
"enabled": true
}
}
}
```
> 注意：需要先启动 HTTP 服务器（见下文）。
**Claude Desktop / Cursor 配置**：
```json
{
"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 服务器**：
```bash
# 启动 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 服务器：
```typescript
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 包使用
```bash
pnpm add @frank-x/dailyhot-mcp
```
```js
import { main } from "@frank-x/dailyhot-mcp";
/**
* 启动 MCP 服务（stdio 模式）
* @returns {Promise}
*/
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` 工具获取完整列表。
查看支持的平台
| **站点** | **类别** | **调用名称** | **站点** | **类别** | **调用名称** |
| ---------------| ---------- | ------------ | -------------| ---------- | ------------ |
| 哔哩哔哩 | 热门榜 | bilibili | 知乎 | 热榜 | zhihu |
| 微博 | 热搜榜 | weibo | 知乎日报 | 推荐榜 | zhihu-daily |
| 百度 | 热搜榜 | baidu | 抖音 | 热点榜 | douyin |
| 快手 | 热点榜 | kuaishou | 豆瓣电影 | 新片榜 | douban-movie|
| 豆瓣讨论小组 | 讨论精选 | douban-group | 百度贴吧 | 热议榜 | tieba |
| 少数派 | 热榜 | sspai | IT之家 | 热榜 | ithome |
| IT之家喜加一 | 最新动态 | ithome-xijiayi | 简书 | 热门推荐 | jianshu |
| 果壳 | 热门文章 | guokr | 澎湃新闻 | 热榜 | thepaper |
| 今日头条 | 热榜 | toutiao | 36 氪 | 热榜 | 36kr |
| 51CTO | 推荐榜 | 51cto | CSDN | 排行榜 | csdn |
| NodeSeek | 最新动态 | nodeseek | 稀土掘金 | 热榜 | juejin |
| 腾讯新闻 | 热点榜 | qq-news | 新浪网 | 热榜 | sina |
| 新浪新闻 | 热点榜 | sina-news | 网易新闻 | 热点榜 | netease-news|
| 吾爱破解 | 榜单 | 52pojie | 全球主机交流 | 榜单 | hostloc |
| 虎嗅 | 24小时 | huxiu | 酷安 | 热榜 | coolapk |
| 虎扑 | 步行街热帖 | hupu | 爱范儿 | 快讯 | ifanr |
| 英雄联盟 | 更新公告 | lol | 米游社 | 最新消息 | miyoushe |
| 原神 | 最新消息 | genshin | 崩坏3 | 最新动态 | honkai |
| 崩坏星穹铁道 | 最新动态 | starrail | 微信读书 | 飙升榜 | weread |
| NGA | 热帖 | ngabbs | V2EX | 主题榜 | v2ex |
| HelloGitHub | Trending | hellogithub | 中央气象预警 | 全国气象预警 | weatheralarm |
| 中国地震台 | 地震速报 | earthquake | 历史上的今天 | 月-日 | history |
| AcFun | 排行榜 | acfun | Hacker News | 热榜 | hackernews |
| Product Hunt | 热榜 | producthunt | 纽约时报 | 热榜 | nytimes |
| Linux.do | 热榜 | linuxdo | 游民星空 | 热榜 | gameres |
| 极客公园 | 热榜 | geekpark | 什么值得买 | 热榜 | smzdm |
| 数码窝 | 热榜 | dgtle | YY | 热榜 | yystv |
| 水木社区 | 热榜 | newsmth | | | |
## 部署
### Docker 部署
```bash
# 构建
docker build -t dailyhot-mcp .
# 运行
docker run --restart always -p 6688:6688 -d dailyhot-mcp
# 或使用 Docker Compose
docker-compose up -d
```
### 手动部署
```bash
git clone https://github.com/FrankXMX/dailyhotmcp.git
cd dailyhotmcp
pnpm install
```
复制 `.env.example` 为 `.env` 并修改配置。
#### 开发
```bash
pnpm dev
```
#### 编译运行
```bash
pnpm build
pnpm start
```
### pm2 部署
```bash
pnpm i pm2 -g
pnpm build
sh ./deploy.sh
```
## 须知
- 默认缓存 60 分钟，可在 `.env` 中修改 `CACHE_TTL`
- 部分接口使用页面爬虫，若违反对应页面规则请联系移除
## 免责声明
- 本项目服务仅供技术研究和开发测试使用
- 获取的信息来自公开渠道，不对准确性作出承诺
- 使用本项目产生的法律责任由使用者自行承担
## 鸣谢
- [RSSHub](https://github.com/DIYgod/RSSHub)
- [DailyHotApi](https://github.com/imsyy/DailyHotApi)
