heurix-mcp-server

# Serveur MCP Heurix Permet à un agent IA (Claude Desktop, Cursor, ou tout autre client MCP) d'interroger directement un catalogue Heurix — recherche, parcours par catégorie, statistiques — sans que l'agent ait à connaître l'API REST. Chantier 6.1 de la roadmap, 24 juillet 2026. Trois tools exposés : - **`heurix_search`** — recherche par mot-clé, tolérante aux fautes de frappe - **`heurix_browse`** — liste les produits d'une catégorie, avec tri (stock, prix, popularité...) - **`heurix_catalog_stats`** — liste les catalogues et leurs catégories disponibles Une fine couche au-dessus de l'API REST Heurix existante — aucune nouvelle logique métier, juste une nouvelle façade que les agents IA savent parler nativement. ## Installation ```bash pip install -r requirements.txt ``` Testable en local avant de le brancher à un client : ```bash HEURIX_API_KEY=hx_votre_cle python3 server.py ``` (Le serveur attend alors une connexion MCP sur stdin/stdout — `Ctrl+C` pour arrêter. C'est normal qu'il ne "fasse rien" visuellement : un client MCP doit s'y connecter pour que quoi que ce soit se passe.) ## Configuration dans Claude Desktop 1. Ouvrez Claude Desktop → **Réglages → Développeur → Modifier la configuration** (ça crée le fichier s'il n'existe pas encore) 2. Le fichier se trouve à : - macOS : `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows : `%APPDATA%\Claude\claude_desktop_config.json` 3. Ajoutez (ou complétez s'il existe déjà d'autres serveurs) : ```json { "mcpServers": { "heurix": { "command": "/usr/bin/python3", "args": ["/chemin/complet/vers/heurix-mcp-server/server.py"], "env": { "HEURIX_API_KEY": "hx_votre_cle_api", "HEURIX_API_BASE": "https://api.heurix.fr" } } } } ``` **Important** : utilisez le **chemin complet** vers `python3` (`which python3` dans un terminal pour le trouver), pas juste `python3` — Claude Desktop lance la configuration avec un PATH minimal, une commande …