# GitHub Trend Radar MCP Server

🔭 实时追踪 GitHub 开源���界的脉搏 — 让 AI 助手随时掌握技术趋势。

## 这是什么

一个 MCP (Model Context Protocol) Server，让 Claude、Cursor、Codex 等 AI 工具能够：
- 查询 GitHub 今日/本周/本月 Trending 项目
- 分析编程语言和技术栈趋势
- 生成可视化趋势报告
- 跨时段对比项目增长势头

## 安装

```bash
pip install git+https://github.com/cqnxnzg/github-trend-radar.git
```

或者克隆后本地安装：

```bash
git clone https://github.com/cqnxnzg/github-trend-radar.git
cd github-trend-radar
pip install -e .
```

> 💡 注意：需要 Python 3.10+。安装后即可在 Claude Desktop / Cursor / Codex 中配置使用。

## 配置

### Claude Desktop

在 `claude_desktop_config.json` 中添加：

```json
{
  "mcpServers": {
    "github-trend-radar": {
      "command": "python",
      "args": ["-m", "github_trend_radar.server"]
    }
  }
}
```

### Cursor / Codex

在你的 MCP 配置文件中添加相同配置。

## 可用 Tools

| Tool | 说明 | 参数 |
|------|------|------|
| `get_trending_repos` | 获取 GitHub Trending 项目列表 | `since`: daily/weekly/monthly, `language`: 可选过滤语言 |
| `analyze_language_trends` | 分析编程语言分布趋势 | `since`: daily/weekly/monthly |
| `get_repo_details` | 获取单个仓库的详细信息 | `owner`, `repo` |
| `generate_trend_report` | 生成完整的趋势分析报告 | `since`: daily/weekly/monthly, `top_n`: 返回前 N 个项目 |
| `compare_timeframes` | 跨时段对比项目增长势头 | `repo_names`: 仓库名列表 |
| `get_hot_keywords` | 分析当前热门技术关键词 | `since`: daily/weekly/monthly |

## 使用示例

在 Claude Desktop 中直接对话：

> "帮我看看今天 GitHub 上最火的项目有哪些？"

> "最近一周 AI Agent 相关的项目增长趋势如何？"

> "帮我对比一下 openai/codex 和 openinterpreter/openinterpreter 的增长势头"

> "生成一份本月 GitHub Trending 的完整分析报告"

## 架构

```
┌─────────────────┐     MCP Protocol     ┌──────────────────┐
│  AI 助手         │ ◄──────────────────► │  Trend Radar     │
│  (Claude/Cursor) │     (stdio/SSE)      │  MCP Server      │
└─────────────────┘                      └────────┬─────────┘
                                                   │
                                          ┌────────▼─────────┐
                                          │  GitHub Trending  │
                                          │  + 数据分析引擎    │
                                          └──────────────────┘
```

## 托管服务（即将推出）

不想自己部署？我们提供托管版本：

- 🆓 **免费层**：每天 10 次查询
- ⭐ **Pro 层**：¥29/月，无限查询 + 历史数据
- 🏢 **Team 层**：¥99/月，多人协作 + 定制报告

## License

MIT