# tech-watch-mcp

A Model Context Protocol (MCP) server that gives Claude real-time access to tech news, trending repositories, research papers, and developer community content.

## Tools

| Tool | Description |
|------|-------------|
| `get_trending_topics` | Top stories from Hacker News |
| `get_github_trending` | Trending repositories on GitHub (filterable by language) |
| `get_papers` | Recent papers from ArXiv by keyword |
| `get_community_buzz` | Top articles from dev.to by tag |
| `get_daily_brief` | Combined daily brief from all sources |
| `deep_dive` | Extract full text from any article URL |
| `compare_sources` | Compare how a topic is covered across all sources |

## Example prompts in Claude

```
Donne-moi le brief tech du jour sur l'IA
```
```
Quels sont les repos GitHub trending en Python cette semaine ?
```
```
Fais un deep dive sur cet article : <url>
```
```
Compare comment le sujet "rust" est couvert sur HN, GitHub et ArXiv
```

## Setup

**1. Clone & create virtual environment**
```bash
git clone https://github.com/LePhyX/tech-watch-mcp
cd tech-watch-mcp
python3 -m venv .venv
source .venv/bin/activate
```

**2. Install dependencies**
```bash
pip install -r requirements.txt
```

**3. Connect to Claude Code**
```bash
claude mcp add tech-watch -- /path/to/tech-watch-mcp/.venv/bin/python /path/to/tech-watch-mcp/server.py
```

## Sources

- [Hacker News API](https://github.com/HackerNews/API) — public, no auth required
- [GitHub Trending](https://github.com/trending) — scraped via BeautifulSoup
- [ArXiv API](https://arxiv.org/help/api) — public, no auth required
- [dev.to API](https://developers.forem.com/api) — public, no auth required