Skip to main content
Glama
Le Parrain MCP

Le Parrain MCP

by Wobani034

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 et des garde-fous
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

Related MCP server: Backlinks MCP

Outils principaux

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

get_best_referral

Donne le lien de parrainage résolu pour une marque

compare_programs

Compare deux programmes et leurs liens

search_blog

Cherche dans les articles publiés

create_announcement

Publie votre annonce (compte connecté)

list_pro_programs

Liste les programmes partenaires acceptant des recommandations (connecté)

recommend_contact

Transmet un contact consentant après confirmation explicite (connecté)

get_my_commissions

Suit les commissions de recommandation du compte (connecté)

Les outils de recommandation n'inscrivent et n'administrent aucun professionnel. Ils sont réservés à l'utilisateur connecté qui recommande un contact consentant, et ne renvoient pas les coordonnées du contact après l'envoi.

suggest_program n'est pas exposé par le serveur : sa file de modération actuelle est en mémoire et ne garantit pas la conservation d'une proposition.

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

Sans connexion, les cinq outils de découverte en lecture seule sont disponibles : search_programs, get_program, get_best_referral, compare_programs et search_blog. Le lien servi est celui résolu pour un visiteur anonyme. Les outils personnels, de publication et de transmission de données exigent un compte Le Parrain connecté par OAuth. Un token fourni mais invalide déclenche un défi OAuth ; une panne de l'API renvoie une erreur temporaire. 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 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 !

Available Tools

4 tools
get_programDétail d'un programmeA

Renvoie le détail d'un programme de parrainage (description + lien de parrainage résolu pour vous).

Inputs: slug (required).

search_blogChercher dans le blogA

Cherche dans les articles du blog Le Parrain (conseils, comparatifs, bons plans parrainage) et renvoie les programmes liés. Utile pour des questions plus larges qu'une simple recherche de programme.

Inputs: query (required).

search_programsRechercher des programmes de parrainageA

Cherche des programmes de parrainage dans l'annuaire Le Parrain. Renvoie pour chaque résultat le bon lien de parrainage (le vôtre si vous êtes connecté et l'avez publié, sinon le lien par défaut).

Inputs: query (required).

suggest_programProposer un nouveau programmeA

Propose un programme de parrainage absent de l'annuaire. La proposition passe en modération (vérification humaine) avant toute publication — aucune mise en ligne automatique.

Inputs: name (required), url, category.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct action: retrieving program details, searching blog articles, searching programs, and suggesting missing programs. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (get_program, search_blog, search_programs, suggest_program), making them predictable and easy to distinguish.

    Tool Count5/5

    With 4 tools, the set is tightly scoped to the core functionality of a referral program directory: discovering, detailing, and suggesting programs, plus supporting blog content. No tool feels extraneous or missing.

    Completeness4/5

    The set covers the main use cases: program search, detail retrieval, blog advice, and program suggestions. Lacks explicit update or delete actions, but those may be out of scope for a directory service.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers