Operaciones empresarialesFuente pública

Loyalty MCP Server

Una capa de programa de lealtad para agentes de ADK-Rust Enterprise. 18 herramientas MCP sobre miembros, libro mayor de puntos, niveles, catálogo de recompensas, redenciones y ofertas promocionales — para agentes de membresía, saldo de puntos y recompensas.

Abrir el código fuente Lee la guía oficial ↗

Qué le ofrece al agente

Una capacidad diseñada específicamente detrás de una conexión MCP.

El servidor posee su lógica de dominio y publica un contrato de herramienta que un cliente MCP puede descubrir. ADK-Rust puede cargar ese contrato en un agente, normalizar cada esquema para el proveedor de modelo elegido y mantener el ciclo de vida de la conexión fuera de la lógica de negocio del agente.

Proporciona capacidades de lealtad mediante un contrato MCP tipado.

Arquitectura

Cómo Loyalty MCP Server encaja en un sistema de agentes.

El modelo nunca necesita los detalles de implementación ni las credenciales del sistema detrás del servidor. Ve definiciones de herramientas revisadas. El cliente MCP maneja el descubrimiento y las llamadas, mientras el servidor mantiene la propiedad de la validación, políticas y comunicación con su sistema de dominio.

Agente ADK-Rust

Elige una capacidad del catálogo de herramientas revisado.

→

Cliente MCP

Descubre esquemas, envía llamadas y recibe contenido tipado.

→

Loyalty MCP Server

Valida la solicitud y posee 18 contratos de herramientas documentados.

→

Sistema de dominio

Mantiene la API, datos, credenciales y reglas de negocio detrás del servidor.

Conexión: stdio · Marco del servidor: ADK MCP SDK + rmcp

Catálogo de herramientas

¿Qué puede pedir un agente a Loyalty MCP Server?

Cada herramienta tiene un nombre estable, un propósito legible para humanos y un contrato de entrada JSON descubierto durante la inicialización MCP. Las clases de riesgo provienen del manifiesto del registro del proyecto cuando está disponible.

18 herramientas nombradas

enroll_member

Registrar un nuevo miembro de lealtad

internal write

get_member

Obtener cuenta, nivel y saldos de un miembro

read only

find_member

Buscar miembros por número de membresía o nombre

read only

set_member_status

Cambiar estado de cuenta de un miembro

internal write

get_balance

Obtener saldo de puntos y progreso de nivel

read only

earn_points

Ganar puntos por gasto (se aplican multiplicadores de nivel y oferta)

internal write

award_points

Otorgar puntos directamente (bono/gesto de buena voluntad)

internal write

adjust_points

Ajustar puntos manualmente hacia arriba o abajo

internal write

expire_points

Expirar puntos del saldo de un miembro

internal write

get_ledger

Obtener historial del libro mayor de puntos de un miembro

read only

create_reward

Crear una recompensa del catálogo

internal write

list_rewards

Listar recompensas activas (opcionalmente filtradas por nivel para un miembro)

read only

Gobernanza

Entiende el efecto de cada herramienta.

Una conexión de servidor hereda la autoridad de sus credenciales y entorno de despliegue. Las declaraciones a continuación provienen del README de este proyecto y del manifiesto del registro MCP; tu aplicación aún decide qué herramientas recibe un agente y dónde se requiere aprobación.

11 internal write7 read only

Escrituras de puntos restringidas — earn_points, award_points, adjust_points, expire_points, redeem_reward y set_redemption_status requieren aprobación en producción (mueven puntos con valor monetario);…
Integridad del saldo — todos los cambios pasan por el libro mayor; el saldo nunca puede ser negativo y las cancelaciones se revierten con asientos compensatorios.
Sin PII crudo — los miembros llevan una referencia de contacto, no necesariamente detalles de contacto crudos.
Andamiaje de integración — el almacenamiento en memoria es para desarrollo; respáldelo con un almacenamiento duradero y vincule actores a identidades autenticadas en producción.

Superficie MCP

Qué declara la documentación actual.

MCP puede transportar herramientas, recursos, indicaciones, resultados estructurados, progreso, cancelación y trabajo de larga duración. Este registro destaca las características modernas del protocolo mencionadas explícitamente por este repositorio.

Cancelación

ADK MCP SDKrmcpManifiesto del registro

Instalar y conectar

Sigue el punto de partida documentado del proyecto.

Instala el servidor en el entorno que posee sus credenciales y acceso al dominio. Agrégalo a tu host MCP, verifica las herramientas descubiertas y limita el conjunto de herramientas antes de entregarlo a un agente en producción.

Instalar

cargo install mcp-loyalty

Forma de conexión ADK-Rust

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

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

Los comandos y la configuración se extraen del README público. Confirma los prerrequisitos, variables de entorno y opciones específicas de la versión en la documentación oficial antes del despliegue.

Documentación oficial

Continúa con la fuente de verdad de los mantenedores del proyecto.

Esta página ofrece un mapa accesible del servidor. El repositorio sigue siendo la autoridad para esquemas exactos, prerrequisitos, configuración, ejemplos, pruebas, versiones y actualizaciones de seguridad.

Descripción general ↗README.md REGISTRO DE CAMBIOS ↗CHANGELOG.md Arquitectura ↗docs/architecture.svg Problemas y soporte ↗problemas en github.com

Seguir explorando