# What Happen MCP

为 [What Happen](https://github.com/LYX9527/what-happen) 项目提供后端数据服务的 MCP (Model Context Protocol) 服务器。

## 项目简介

本项目是 [What Happen](https://github.com/LYX9527/what-happen) 新闻聚合平台的官方 MCP 服务器，提供：

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

## 与 What Happen 前端的配合

本项目专为 [What Happen](https://github.com/LYX9527/what-happen) 前端项目提供后端 API 服务，支持：

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

### 配置 What Happen 前端

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

```bash
VITE_API_BASE_URL=http://localhost:10010
```

## 安装

### 作为 CLI 工具使用

```bash
# 全局安装
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（无需安装）：**
```json
{
  "mcpServers": {
    "what-happen": {
      "command": "npx",
      "args": [
        "-y",
        "what-happen-mcp@latest"
      ]
    }
  }
}
```

**全局安装版本：**
```json
{
  "mcpServers": {
    "what-happen": {
      "type": "stdio",
      "command": "what-happen-mcp",
      "env": {},
      "alwaysAllow": ["get_news_by_platform", "get_news_by_category", "list_platforms"]
    }
  }
}
```

**本地路径版本：**
```json
{
  "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 使用方法

### 列出所有可用平台

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

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

### 获取特定平台新闻

```bash
# 获取 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
```

### 获取分类新闻

```bash
# 获取科技资讯
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 使用示例

```json
{
  "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等

### 汽车资讯
- 懂车帝、汽车之家等

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

## 开发

### 本地开发

```bash
# 克隆仓库
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`: 返回数量限制（可选）

响应格式：
```json
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": "string",
      "title": "string",
      "url": "string",
      "extra": {
        "info": "string",
        "time": "string",
        "rank": 0,
        "thumbnail": { "url": "string" }
      }
    }
  ]
}
```

## 许可证

本项目采用 MIT 许可证 - 与 [What Happen](https://github.com/LYX9527/what-happen) 前端项目保持一致。

## 相关项目

- [What Happen 前端](https://github.com/LYX9527/what-happen) - 现代化的新闻聚合平台前端
- [What Happen MCP](https://github.com/LYX9527/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 技术构建
- 为统一新闻阅读体验而生