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

Related MCP server: Backlinks MCP

Les 4 tools

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

Brancher à un client MCP

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 !