What Happen MCP

为 What Happen 项目提供后端数据服务的 MCP (Model Context Protocol) 服务器。

项目简介

本项目是 What Happen 新闻聚合平台的官方 MCP 服务器，提供：

• 📰 多平台新闻聚合: 支持 70+ 新闻平台的数据获取
• 🔌 MCP 协议支持: 可作为 MCP 工具集成到支持 MCP 的应用中
• 🖥️ CLI 工具: 独立的命令行工具，支持 JSON 和友好格式输出
• 🚀 高性能: 基于 Cheerio + Axios 的轻量级爬虫方案

与 What Happen 前端的配合

本项目专为 What Happen 前端项目提供后端 API 服务，支持：

• GET /platforms - 获取可用新闻平台配置
• GET /news - 获取新闻数据，支持平台过滤

配置 What Happen 前端

在前端项目的 .env 文件中配置：

VITE_API_BASE_URL=http://localhost:10010

安装

作为 CLI 工具使用

# 全局安装
npm install -g what-happen-mcp

# 或本地安装
npm install what-happen-mcp

# 或使用 npx 直接运行（无需安装）
npx what-happen-mcp

使用 npx 的优势

• 无需安装：直接运行，不占用全局空间
• 自动更新：每次运行都使用最新版本
• 版本灵活：可以指定特定版本 npx what-happen-mcp@0.1.0

作为 MCP 服务器使用

在 MCP 配置文件中添加：

推荐使用 npx（无需安装）：

{
  "mcpServers": {
    "what-happen": {
      "command": "npx",
      "args": [
        "-y",
        "what-happen-mcp@latest"
      ]
    }
  }
}

全局安装版本：

{
  "mcpServers": {
    "what-happen": {
      "type": "stdio",
      "command": "what-happen-mcp",
      "env": {},
      "alwaysAllow": ["get_news_by_platform", "get_news_by_category", "list_platforms"]
    }
  }
}

本地路径版本：

{
  "mcpServers": {
    "what-happen": {
      "type": "stdio",
      "command": "node",
      "args": [
        "path/to/what-happen-mcp/build/index.js"
      ],
      "env": {},
      "alwaysAllow": ["get_news_by_platform", "get_news_by_category", "list_platforms"]
    }
  }
}

平台差异说明:

• Linux/macOS: 直接使用 node 命令和脚本路径。Node.js 在这些系统上可作为可执行文件直接访问。
• Windows: 使用 cmd /c 前缀来通过命令处理器运行 node。这是因为 Windows 上 Node.js 通常作为 .cmd 脚本安装在 PATH 中，需要 cmd 来解析。
• 跨平台替代方案: 如果你的环境已配置，也可在 Windows 上尝试直接使用 node 命令（某些 Node.js 安装方式支持），或使用 node.cmd。

请将 path/to/what-happen-mcp 替换为实际的项目路径（绝对路径推荐）。

CLI 使用方法

列出所有可用平台

# 使用 npx 直接运行（推荐）
npx what-happen list

# 或使用全局安装的命令
what-happen list

获取特定平台新闻

# 获取 GitHub 热门项目
npx what-happen get --platform github --limit 5

# 获取微博热搜
npx what-happen get --platform weibo --limit 10

# JSON 格式输出
npx what-happen get --platform zhihu --json

获取分类新闻

# 获取科技资讯
npx what-happen get --category tech --limit 15

# 获取热搜榜
npx what-happen get --category hot --limit 20

MCP 工具

可用工具

1. get_news_by_platform - 获取特定平台新闻

   • 参数: platform (必需), limit (可选)
   • 支持平台: weibo, github, zhihu, baidu 等 70+ 平台

2. get_news_by_category - 获取分类新闻

   • 参数: category (必需), limit (可选)
   • 支持分类: hot, tech, finance, social, entertainment, sports, car

3. list_platforms - 列出所有平台和分类

   • 参数: 无

MCP 使用示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_news_by_platform",
    "arguments": {
      "platform": "github",
      "limit": 5
    }
  }
}

支持的平台

热搜榜

• 微博热搜、百度热搜、抖音热点、知乎热榜、快手热门、今日头条

科技资讯

• GitHub趋势、36氪、IT之家、Solidot、V2EX、掘金、CSDN、少数派等

社会新闻

• 澎湃新闻、参考消息、联合早报、贴吧、靠谱新闻、虎扑

娱乐资讯

• B站热门、豆瓣电影、百度电视剧、酷狗音乐、QQ音乐等

体育赛事

• 虎扑LOL、FIFA、NBA、CBA、中超、Valorant等

汽车资讯

• 懂车帝、汽车之家等

财经新闻

• 华尔街见闻、集思录、财联社、格隆汇、股票市场等

开发

本地开发

# 克隆仓库
git clone https://github.com/LYX9527/what-happen-mcp.git
cd what-happen-mcp

# 安装依赖
npm install

# 构建
npm run build

# 运行 CLI
npm run cli -- list

# 运行 MCP 服务器
npm start

添加新平台

1. 在 src/aggregator.ts 中添加新的 API 函数
2. 在 initializeApis() 方法中注册新平台
3. 更新 initializePlatforms() 中的平台配置
4. 重新构建项目

API 接口

获取平台列表

GET /platforms

返回所有可用的新闻平台配置。

获取新闻数据

GET /news?platform={platform}&limit={limit}

参数：

• platform: 平台名称（可选）
• limit: 返回数量限制（可选）

响应格式：

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": "string",
      "title": "string",
      "url": "string",
      "extra": {
        "info": "string",
        "time": "string",
        "rank": 0,
        "thumbnail": { "url": "string" }
      }
    }
  ]
}

许可证

本项目采用 MIT 许可证 - 与 What Happen 前端项目保持一致。

相关项目

• What Happen 前端 - 现代化的新闻聚合平台前端
• What Happen MCP - 本项目，提供后端数据服务

贡献

欢迎贡献代码！请查看贡献指南了解详情。

• Fork 本仓库
• 创建功能分支 (git checkout -b feature/amazing-feature)
• 提交更改 (git commit -m 'Add some amazing feature')
• 推送到分支 (git push origin feature/amazing-feature)
• 创建 Pull Request

致谢

• 感谢所有提供公开 API 的新闻平台
• 使用 Vue 3 和现代 Web 技术构建
• 为统一新闻阅读体验而生