Operações de negóciosCódigo-fonte público

Loyalty MCP Server

Uma camada de programa de fidelidade para agentes ADK-Rust Enterprise. 18 ferramentas MCP sobre membros, um livro razão de pontos, níveis, catálogo de recompensas, resgates e ofertas promocionais — para agentes de associação, saldo de pontos e recompensas.

Abrir o código-fonte Leia o guia oficial ↗

O que ele oferece a um agente

Uma capacidade feita sob medida por trás de uma conexão MCP.

O servidor possui sua lógica de domínio e publica um contrato de ferramenta que um cliente MCP pode descobrir. O ADK-Rust pode carregar esse contrato em um agente, normalizar cada esquema para o provedor de modelo escolhido e manter o ciclo de vida da conexão fora da lógica de negócio do agente.

Fornece capacidades de fidelidade através de um contrato MCP tipado.

Arquitetura

Como Loyalty MCP Server se encaixa em um sistema de agente.

O modelo nunca precisa dos detalhes de implementação ou credenciais do sistema por trás do servidor. Ele vê definições de ferramentas revisadas. O cliente MCP lida com descoberta e chamadas, enquanto o servidor mantém a propriedade da validação, política e comunicação com seu sistema de domínio.

Agente ADK-Rust

Escolhe uma capacidade do catálogo de ferramentas revisado.

→

Cliente MCP

Descobre esquemas, envia chamadas e recebe conteúdo tipado.

→

Loyalty MCP Server

Valida a solicitação e possui 18 contratos de ferramentas documentados.

→

Sistema de domínio

Mantém a API, dados, credenciais e regras de negócio por trás do servidor.

Conexão: stdio · Framework do servidor: ADK MCP SDK + rmcp

Catálogo de ferramentas

O que um agente pode pedir para Loyalty MCP Server fazer?

Cada ferramenta tem um nome estável, um propósito legível por humanos e um contrato de entrada JSON descoberto durante a inicialização MCP. Classes de risco vêm do manifesto do registro do projeto quando disponível.

18 ferramentas nomeadas

enroll_member

Registrar um novo membro de fidelidade

internal write

get_member

Obter conta, nível e saldos de um membro

read only

find_member

Encontrar membros por número de associação ou nome

read only

set_member_status

Alterar status da conta de um membro

internal write

get_balance

Obter saldo de pontos e progresso no nível

read only

earn_points

Ganhar pontos por gastos (multiplicadores de nível + oferta aplicados)

internal write

award_points

Conceder pontos diretamente (bônus/boa vontade)

internal write

adjust_points

Ajustar pontos manualmente para cima ou para baixo

internal write

expire_points

Expirar pontos do saldo de um membro

internal write

get_ledger

Obter histórico do livro razão de pontos de um membro

read only

create_reward

Criar uma recompensa no catálogo

internal write

list_rewards

Listar recompensas ativas (opcionalmente filtradas por nível para um membro)

read only

Governança

Entenda o efeito de cada ferramenta.

Uma conexão de servidor herda a autoridade de suas credenciais e do ambiente de implantação. As declarações abaixo vêm do README deste projeto e do manifesto do registro MCP; sua aplicação ainda decide quais ferramentas um agente recebe e onde a aprovação é necessária.

11 internal write7 read only

Escritas de pontos controladas — ganhar_pontos, conceder_pontos, ajustar_pontos, expirar_pontos, resgatar_recompensa e definir_status_resgate requerem aprovação em produção (movimentam pontos com valor monetário);…
Integridade do saldo — todas as alterações passam pelo livro razão; o saldo nunca pode ficar negativo, e cancelamentos são revertidos via lançamentos compensatórios.
Sem PII bruto — membros carregam uma referência de contato, não necessariamente detalhes de contato brutos.
Estrutura de integração — o armazenamento em memória é para desenvolvimento; suporte com armazenamento durável e vincule atores a identidades autenticadas em produção.

Superfície MCP

O que a documentação atual declara.

O MCP pode transportar ferramentas, recursos, prompts, resultados estruturados, progresso, cancelamento e trabalhos de longa duração. Este registro destaca os recursos modernos do protocolo explicitamente mencionados por este repositório.

Cancelamento

ADK MCP SDKrmcpManifesto do registro

Instalar e conectar

Siga o ponto de partida documentado do projeto.

Instale o servidor no ambiente que possui suas credenciais e acesso ao domínio. Adicione-o ao seu host MCP, verifique as ferramentas descobertas e restrinja o conjunto de ferramentas antes de entregá-lo a um agente de produção.

Instalar

cargo install mcp-loyalty

Formato de conexão ADK-Rust

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

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

Comandos e configurações são extraídos do README público. Confirme pré-requisitos, variáveis de ambiente e opções específicas da versão na documentação oficial antes da implantação.

Documentação oficial

Continue com a fonte de verdade dos mantenedores do projeto.

Esta página fornece um mapa acessível do servidor. O repositório permanece autoritativo para esquemas exatos, pré-requisitos, configuração, exemplos, testes, versões e atualizações de segurança.

Visão Geral ↗README.md CHANGELOG ↗CHANGELOG.md Arquitetura ↗docs/architecture.svg Problemas e suporte ↗problemas no github.com

Continue explorando