Le Parrain MCP

Le Parrain MCP

Serveur MCP (Model Context Protocol) pour interroger l'annuaire de parrainage leparrain.com directement depuis un assistant IA (ChatGPT, Claude…), avec injection automatique du bon lien de parrainage.

Repo volontairement séparé du Parrain. Aucun code source ni accès base du dépôt principal. Aucun secret n'est commité. Ce dépôt peut être public sans rien exposer.

---

Démarrage rapide (POC)

npm install
cp .env.example .env     # ajustez LP_USER pour simuler un appelant connecté
npm run smoke            # tests de la logique (11 assertions)
npm start                # lance le serveur MCP (transport stdio)

Le POC tourne sur un dataset d'exemple en mémoire (LP_DATA_MODE=sample) : aucune infra Le Parrain requise.

Simuler un appelant

| .env | Comportement | |--------|--------------| | LP_USER= (vide) | Appelant anonyme → lien plateforme par défaut | | LP_USER=marie | Connectée, a déjà publié des liens → ses liens ressortent | | LP_USER=zoe | Connectée sans lien → lien plateforme + invitation à créer |

Les 4 tools

| Tool | Rôle | |------|------| | search_programs | Cherche des programmes, renvoie le lien résolu pour vous | | get_program | Détail d'un programme + lien résolu | | create_referral_link | Publie votre lien (connecté, https, anti-doublon) | | suggest_program | Propose un programme → modération (pas de publication auto) |

La logique de choix du lien (« chaîne de résolution ») est décrite dans PLAN.md.

Brancher à un client MCP

Option A — Remote (URL à coller, recommandé)

Serveur en ligne, aucun fichier à éditer : collez l'URL dans un connecteur custom de ChatGPT / Claude.

https://leparrain.com/mcp

POC ouvert sans auth → appelant anonyme → lien plateforme par défaut. Endpoint de santé : GET https://leparrain.com/mcp/health.

Déploiement (serveur Plesk) : process PM2 leparrain-mcp (src/http.js, port 127.0.0.1:3005), reverse-proxy nginx location /mcp dans le vhost_nginx.conf de leparrain.com. Process séparé : aucun code ni base du Parrain.

Option B — Local (stdio)

Claude Desktop — claude_desktop_config.json :

{
  "mcpServers": {
    "leparrain": {
      "command": "node",
      "args": ["/chemin/absolu/vers/leparrain-mcp/src/server.js"],
      "env": { "LP_DATA_MODE": "sample", "LP_USER": "" }
    }
  }
}

Inspecteur officiel (pour tester visuellement) :

npm run inspect

Structure

src/
  server.js     # serveur MCP : branche les tools sur le protocole (stdio)
  core.js       # logique métier pure des 4 tools (testable)
  resolver.js   # chaîne de résolution du lien + tirage pondéré
  data.js       # dataset d'exemple (remplacé par l'API en couche 2)
  flavor.js     # la voix du Parrain (clins d'œil The Mask)
test/smoke.js   # tests de la logique pure
landing/        # landing page de présentation

Sécurité

• .env est gitignored. Ne commitez jamais de clé.
• En production (couche 2), le serveur tape l'API publique de leparrain.com

via LP_API_KEY (fournie à l'exécution) — jamais d'accès base direct, jamais de source du Parrain dans ce repo.

— Ssssplendide !