타입화된 MCP 계약을 통한 로열티 기능 제공.
Loyalty MCP Server
ADK-Rust Enterprise 에이전트를 위한 로열티 프로그램 계층. 회원, 포인트 원장, 등급, 보상 카탈로그, 교환, 프로모션 오퍼를 다루는 18개 MCP 도구.
에이전트에게 제공하는 것
하나의 MCP 연결 뒤에 구축된 목적 특화 기능입니다.
서버는 도메인 로직을 소유하며 MCP 클라이언트가 발견할 수 있는 도구 계약을 게시합니다. ADK-Rust는 그 계약을 에이전트에 로드하고, 선택한 모델 공급자에 맞게 각 스키마를 정규화하며, 연결 수명 주기를 에이전트의 비즈니스 로직 밖에서 관리합니다.
아키텍처
Loyalty MCP Server이(가) 에이전트 시스템에 어떻게 적합한지.
모델은 서버 뒤 시스템의 구현 세부사항이나 자격 증명을 절대 필요로 하지 않습니다. 검토된 도구 정의만 봅니다. MCP 클라이언트가 발견과 호출을 처리하며, 서버는 검증, 정책, 도메인 시스템과의 통신을 소유합니다.
ADK-Rust 에이전트
검토된 도구 카탈로그에서 기능을 선택합니다.
MCP 클라이언트
스키마를 발견하고 호출을 보내며 타입화된 콘텐츠를 수신합니다.
Loyalty MCP Server
요청을 검증하고 18개의 문서화된 도구 계약을 소유합니다.
도메인 시스템
서버 뒤의 API, 데이터, 자격 증명, 비즈니스 규칙을 유지합니다.
프로젝트 문서에서
서버가 게시한 아키텍처
도구 카탈로그
에이전트가 Loyalty MCP Server에게 무엇을 요청할 수 있나요?
각 도구는 안정적인 이름, 사람이 읽을 수 있는 목적, MCP 초기화 중 발견된 JSON 입력 계약을 가집니다. 위험 등급은 프로젝트의 레지스트리 매니페스트에서 제공됩니다(있는 경우).
18개의 명명된 도구들
enroll_member새 로열티 회원 등록
internal writeget_member회원 계정, 등급, 잔액 조회
read onlyfind_member회원 번호 또는 이름으로 회원 찾기
read onlyset_member_status회원 계정 상태 변경
internal writeget_balance포인트 잔액 및 등급 진행 상황 조회
read onlyearn_points지출로부터 포인트 적립(등급 및 오퍼 배수 적용)
internal writeaward_points직접 포인트 부여(보너스/선의)
internal writeadjust_points포인트 수동 조정(증가 또는 감소)
internal writeexpire_points회원 잔액에서 포인트 만료
internal writeget_ledger회원 포인트 원장 기록 조회
read onlycreate_reward카탈로그 보상 생성
internal writelist_rewards활성 보상 목록(선택적으로 회원 등급 필터링)
read only거버넌스
모든 도구의 효과를 이해하세요.
서버 연결은 자격 증명과 배포 환경의 권한을 상속합니다. 아래 선언은 이 프로젝트의 README와 MCP 레지스트리 매니페스트에서 가져온 것이며, 애플리케이션은 에이전트가 어떤 도구를 받고 어디서 승인이 필요한지 결정합니다.
- 포인트 쓰기 작업은 승인 필요 — earn_points, award_points, adjust_points, expire_points, redeem_reward, set_redemption_status는 프로덕션에서 승인 필요(금전적 가치 포인트 이동).
- 잔액 무결성 — 모든 변경은 원장을 통해 이루어지며, 잔액은 음수가 될 수 없고 취소는 보상 항목으로 역전됨.
- 원시 PII 없음 — 회원은 반드시 원시 연락처 정보를 포함하지 않는 연락처 참조를 가짐.
- 통합 스캐폴드 — 인메모리 저장소는 개발용; 프로덕션에서는 내구성 저장소와 인증된 신원에 바인딩된 행위자 필요.
MCP 인터페이스
현재 문서가 선언하는 내용
MCP는 도구, 리소스, 프롬프트, 구조화된 결과, 진행 상황, 취소, 장기 작업을 전달할 수 있습니다. 이 기록은 이 저장소에서 명시적으로 언급한 최신 프로토콜 기능을 강조합니다.
설치 및 연결
프로젝트 문서에 명시된 시작점을 따르세요.
자격 증명과 도메인 접근 권한을 소유한 환경에 서버를 설치하세요. MCP 호스트에 추가하고 발견된 도구를 검증한 후 도구 세트를 좁혀 프로덕션 에이전트에 제공합니다.
cargo install mcp-loyaltylet toolset = McpToolset::from_stdio(
"mcp-loyalty",
["mcp-loyalty"],
).await?;
let agent = LlmAgentBuilder::new("agent")
.tools(toolset.tools().await?)
.build()?;명령과 구성은 공개 README에서 추출됩니다. 배포 전에 공식 문서에서 전제 조건, 환경 변수, 릴리스별 옵션을 확인하세요.
공식 문서
프로젝트 유지 관리자의 신뢰할 수 있는 출처를 계속 사용하세요.
이 페이지는 서버의 친근한 지도를 제공합니다. 저장소는 정확한 스키마, 전제 조건, 구성, 예제, 테스트, 릴리스, 보안 업데이트에 대해 권위 있는 출처로 남아 있습니다.
계속 탐색하기
비즈니스 운영에서 더 보기.
소스 기록
이 카탈로그 항목의 릴리스 및 저장소 메타데이터입니다.
- 버전
- 1.0.0
- 라이선스
- Apache-2.0
- 도구
- 18
- 수정
- 9fb44db179eb
- 업데이트됨
- 2026년 6월 9일