🔭 Tech-Watch-MCP

Intelligence tech en temps réel pour Claude — Hacker News, GitHub, ArXiv et dev.to dans une seule conversation.

---

Présentation

tech-watch-mcp est un serveur Model Context Protocol qui connecte Claude à quatre flux d'intelligence technologique simultanément. Posez une question, obtenez une synthèse multi-sources — sans quitter la conversation.

"Quels repos Python ont explosé cette semaine ?"
"Compare comment WebAssembly est couvert sur HN, GitHub et ArXiv."
"Fais un deep dive sur cet article : https://..."

---

Fonctionnalités

• 7 outils MCP couvrant actualités, code, recherche et communauté
• Agrégation multi-sources — un prompt, quatre flux de données
• Extraction d'articles — récupération et parsing complet de n'importe quelle URL
• Comparaison croisée — analyse d'un sujet sur HN, GitHub, ArXiv et dev.to en parallèle
• OAuth 2.0 — accès distant sécurisé avec flux d'approbation protégé par mot de passe
• Déploiement Railway — serveur HTTP persistant, accessible depuis tout client MCP

---

Outils disponibles

Outil	Description	Paramètres clés
get_trending_topics	Top stories Hacker News	limit (défaut : 10)
get_github_trending	Repos les plus étoilés via l'API GitHub	language, since (daily / weekly / monthly)
get_papers	Derniers papers ArXiv par mot-clé	query, limit
get_community_buzz	Articles dev.to par tag	tags (séparés par virgule), limit
get_daily_brief	Brief combiné de toutes les sources	topic
deep_dive	Extraction du texte complet d'une URL	url
compare_sources	Analyse croisée côte à côte	topic

---

Architecture

Claude (client MCP)
        │
        │  MCP protocol (stdio ou streamable-http)
        ▼
    server.py ──── auth.py (fournisseur OAuth 2.0)
        │
        ├── Hacker News API   (public, sans auth)
        ├── GitHub Search API (public, GITHUB_TOKEN recommandé)
        ├── ArXiv API         (public, sans auth)
        └── dev.to API        (public, sans auth)

Transport local (Claude Code CLI) : stdio — le serveur est spawné directement par le client.
Transport distant (Railway) : streamable-http — le serveur écoute sur PORT, OAuth requis.

---

Installation locale

1. Cloner le dépôt et créer l'environnement virtuel

git clone https://github.com/LePhyX/tech-watch-mcp
cd tech-watch-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Connecter à Claude Code

claude mcp add tech-watch -- /path/to/tech-watch-mcp/.venv/bin/python /path/to/tech-watch-mcp/server.py

Vérification :

claude mcp list
# tech-watch: ... - ✔ Connected

---

Déploiement Railway

Variables d'environnement

Variable	Description	Exemple
BASE_URL	URL publique du serveur Railway	https://web-production-xxxx.up.railway.app
AUTH_PASSWORD	Mot de passe pour approuver les connexions OAuth	your-secret-password
GITHUB_TOKEN	Personal access token GitHub (optionnel mais recommandé)	github_pat_...

Note : Sans GITHUB_TOKEN, l'API GitHub est limitée à 60 req/heure. Avec token : 5 000 req/heure.

Étapes de déploiement

1. Créer un projet Railway → Deploy from GitHub repo → sélectionner LePhyX/tech-watch-mcp
2. Ajouter les variables d'environnement ci-dessus
3. Railway détecte le Procfile et démarre automatiquement

Connexion OAuth depuis un client MCP

claude mcp add --transport http tech-watch-remote https://your-server.up.railway.app/mcp

Au premier accès, le client MCP ouvre une page d'autorisation dans le navigateur :

1. Page affichée : https://your-server.up.railway.app/auth/approve
2. Saisir le mot de passe défini dans AUTH_PASSWORD
3. Cliquer Authorize → token émis → connexion établie

Les tokens expirent après 1 heure ; le refresh token renouvelle l'accès automatiquement.

---

Sources de données

Source	API	Authentification
Hacker News	Firebase REST API	Aucune
GitHub	Search Repositories API	Token optionnel
ArXiv	Atom Feed API	Aucune
dev.to	Forem REST API	Aucune

---

Stack technique

Composant	Rôle
Python 3.12	Langage principal
FastMCP	Framework serveur MCP
httpx	Client HTTP async
BeautifulSoup4	Parsing HTML (deep_dive)
Starlette	Framework ASGI (routes OAuth)
Railway	Déploiement cloud

---

Exemples de prompts

Brief tech du jour sur l'IA

Quels repos Python ont explosé cette semaine ?

Fais un deep dive sur cet article : https://...

Compare comment "WebAssembly" est couvert sur HN, GitHub et ArXiv

Donne-moi les derniers papers sur les LLM agents