型付きMCP契約を通じてロイヤルティ機能を提供。
Loyalty MCP Server
ADK-Rust Enterpriseエージェント向けのロイヤルティプログラム層。会員、ポイント台帳、ランク、報酬カタログ、引き換え、プロモーションオファーを管理する18のMCPツール。
エージェントに何を提供するか
1つの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なし — 会員は連絡先参照を持ち、必ずしも生の連絡先詳細ではない。
- 統合スキャフォールド — インメモリストアは開発用;本番では耐久ストアに置き換え、認証済みIDに役者をバインド。
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日