Opérations métierSource publique

Loyalty MCP Server

Une couche de programme de fidélité pour les agents ADK-Rust Enterprise. 18 outils MCP sur les membres, un grand livre de points, niveaux, catalogue de récompenses, utilisations, et offres promotionnelles — pour les agents d'adhésion, solde de points, et récompenses.

Ouvrir la source Lisez le guide officiel ↗

Ce qu'il offre à un agent

Une capacité conçue spécifiquement derrière une connexion MCP unique.

Le serveur possède sa logique de domaine et publie un contrat d'outil qu'un client MCP peut découvrir. ADK-Rust peut charger ce contrat dans un agent, normaliser chaque schéma pour le fournisseur de modèle choisi, et garder le cycle de vie de la connexion en dehors de la logique métier de l'agent.

Fournit des capacités de fidélité via un contrat MCP typé.

Architecture

Comment Loyalty MCP Server s'intègre dans un système d'agent.

Le modèle n'a jamais besoin des détails d'implémentation ou des identifiants du système derrière le serveur. Il voit les définitions d'outils examinées. Le client MCP gère la découverte et les appels, tandis que le serveur conserve la propriété de la validation, de la politique et de la communication avec son système de domaine.

Agent ADK-Rust

Choisit une capacité dans le catalogue d'outils examiné.

→

Client MCP

Découvre les schémas, envoie des appels et reçoit du contenu typé.

→

Loyalty MCP Server

Valide la requête et possède 18 contrats d'outils documentés.

→

Système de domaine

Conserve l'API, les données, les identifiants et les règles métier derrière le serveur.

Connexion : stdio · Cadre serveur : ADK MCP SDK + rmcp

Catalogue d'outils

Que peut demander un agent à Loyalty MCP Server ?

Chaque outil a un nom stable, un but lisible par l'humain, et un contrat d'entrée JSON découvert lors de l'initialisation MCP. Les classes de risque proviennent du manifeste du registre du projet lorsqu'il est disponible.

18 outils nommés

enroll_member

Enregistrer un nouveau membre de fidélité

internal write

get_member

Obtenir le compte, niveau, et soldes d'un membre

read only

find_member

Trouver des membres par numéro d'adhésion ou nom

read only

set_member_status

Changer le statut du compte d'un membre

internal write

get_balance

Obtenir le solde de points et progression de niveau

read only

earn_points

Gagner des points via dépenses (multiplicateurs de niveau + offre appliqués)

internal write

award_points

Attribuer des points directement (bonus/bonne volonté)

internal write

adjust_points

Ajuster manuellement les points à la hausse ou à la baisse

internal write

expire_points

Faire expirer des points du solde d'un membre

internal write

get_ledger

Obtenir l'historique du grand livre de points d'un membre

read only

create_reward

Créer une récompense du catalogue

internal write

list_rewards

Lister les récompenses actives (optionnellement filtrées par niveau pour un membre)

read only

Gouvernance

Comprendre l'effet de chaque outil.

Une connexion serveur hérite de l'autorité de ses identifiants et de son environnement de déploiement. Les déclarations ci-dessous proviennent du README de ce projet et du manifeste du registre MCP ; votre application décide toujours des outils qu'un agent reçoit et des endroits où une approbation est requise.

11 internal write7 read only

Écritures de points contrôlées — earn_points, award_points, adjust_points, expire_points, redeem_reward, et set_redemption_status nécessitent une approbation en production (ils déplacent des points à valeur monétaire);…
Intégrité du solde — tous les changements passent par le grand livre ; le solde ne peut jamais être négatif, et les annulations sont inversées par des écritures compensatoires.
Pas de PII brute — les membres portent une référence de contact, pas nécessairement des détails bruts.
Structure d'intégration — le magasin en mémoire est pour le développement ; le soutenir avec un magasin durable et lier les acteurs à des identités authentifiées en production.

Surface MCP

Ce que la documentation actuelle déclare.

MCP peut transporter des outils, ressources, invites, résultats structurés, progression, annulation et travaux de longue durée. Cet enregistrement met en avant les fonctionnalités modernes du protocole explicitement mentionnées par ce dépôt.

Annulation

ADK MCP SDKrmcpManifeste du registre

Installer et connecter

Suivez le point de départ documenté du projet.

Installez le serveur dans l'environnement qui possède ses identifiants et l'accès au domaine. Ajoutez-le à votre hôte MCP, vérifiez les outils découverts, et réduisez l'ensemble d'outils avant de le confier à un agent en production.

Installer

cargo install mcp-loyalty

Forme de connexion ADK-Rust

let toolset = McpToolset::from_stdio(
    "mcp-loyalty",
    ["mcp-loyalty"],
).await?;

let agent = LlmAgentBuilder::new("agent")
    .tools(toolset.tools().await?)
    .build()?;

Les commandes et la configuration sont extraites du README public. Confirmez les prérequis, variables d'environnement et options spécifiques à la version dans la documentation officielle avant le déploiement.

Documentation officielle

Poursuivez avec la source de vérité des mainteneurs du projet.

Cette page fournit une carte accessible du serveur. Le dépôt reste la référence pour les schémas exacts, prérequis, configuration, exemples, tests, versions et mises à jour de sécurité.

Présentation ↗README.md JOURNAL DES MODIFICATIONS ↗CHANGELOG.md Architecture ↗docs/architecture.svg Problèmes et support ↗problèmes github.com

Continuez à explorer