Metadata-Version: 2.4
Name: aihotradar-mcp
Version: 0.1.0
Summary: AI Hot Radar MCP Server — 让 Claude/Cursor 实时获取 AI 行业热点新闻，无需启动项目后端
Project-URL: Homepage, https://github.com/your-org/aihotradar-mcp
Project-URL: Repository, https://github.com/your-org/aihotradar-mcp
Project-URL: Issues, https://github.com/your-org/aihotradar-mcp/issues
License: MIT
Keywords: ai,claude,cursor,hot-radar,mcp,news
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: feedparser>=6.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: ai
Requires-Dist: openai>=1.0.0; extra == 'ai'
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# aihotradar-mcp

让 Claude Desktop、Cursor、Windsurf 等 AI 工具实时获取 AI 行业热点新闻。

**无需启动项目后端**，独立运行，数据存储于 `~/.aihotradar/data.db`。

## 快速开始

### 安装

```bash
# 使用 uvx（推荐，无需手动安装）
uvx aihotradar-mcp

# 或 pip 安装
pip install aihotradar-mcp

# 启用 AI 深度分析（可选）
pip install "aihotradar-mcp[ai]"
```

### 配置 Claude Desktop

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）
或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：

```json
{
  "mcpServers": {
    "aihotradar": {
      "command": "uvx",
      "args": ["aihotradar-mcp"],
      "env": {
        "AI_API_KEY": "sk-xxx（可选）"
      }
    }
  }
}
```

### 配置 Cursor / Windsurf

在项目的 `.cursor/mcp.json` 或全局 MCP 配置中添加同样的配置。

## 可用工具

| 工具 | 说明 | 是否需要网络 |
|------|------|------------|
| `search_news` | 全文搜索已采集的 AI 新闻 | 否 |
| `get_trending` | 获取热点新闻 | 否 |
| `trigger_scan` | 立即采集并分析最新新闻 | 是 |
| `add_keyword` | 添加监控关键词 | 否 |
| `list_keywords` | 查看关键词及命中统计 | 否 |
| `get_alerts` | 查看关键词命中告警 | 否 |
| `get_scan_history` | 查看历次扫描记录 | 否 |

## 环境变量（全部可选）

| 变量 | 说明 |
|------|------|
| `AI_API_KEY` | AI 分析 Key（DeepSeek / OpenAI 兼容） |
| `AI_BASE_URL` | AI API 地址（默认 `https://api.deepseek.com`） |
| `AI_MODEL` | 模型名称（默认 `deepseek-chat`） |
| `OPENROUTER_API_KEY` | OpenRouter Key（AI_API_KEY 未设置时使用） |

**不配置任何 Key** 时，使用规则评分，仍可正常采集和搜索新闻。

## 数据来源（无需任何 API Key）

- OpenAI / Anthropic / Google DeepMind / Hugging Face 官方博客
- TechCrunch AI、MIT Technology Review、The Verge AI、Ars Technica AI
- HackerNews（AI 相关热帖）
- Papers With Code、arXiv cs.AI / cs.LG
- 机器之心、量子位、36氪
- Google News RSS、Bing News 爬虫

## 许可证

MIT
