عمليات الأعمالالمصدر العام

Loyalty MCP Server

طبقة برنامج الولاء لوكلاء ADK-Rust Enterprise. 18 أداة MCP تغطي الأعضاء، دفتر نقاط، المستويات، كتالوج المكافآت، الاستردادات، والعروض الترويجية — لوكلاء العضوية، رصيد النقاط، والمكافآت.

افتح المصدر اقرأ الدليل الرسمي ↗

ما الذي يقدمه للوكيل

قدرة مخصصة خلف اتصال MCP واحد.

يمتلك الخادم منطق مجاله وينشر عقد أداة يمكن لعميل MCP اكتشافه. يمكن لـ ADK-Rust تحميل هذا العقد في وكيل، تطبيع كل مخطط لمزود النموذج المختار، والحفاظ على دورة حياة الاتصال خارج منطق عمل الوكيل.

يوفر قدرات الولاء من خلال عقد MCP مكتوب النوع.

البنية

كيف يتناسب Loyalty MCP Server مع نظام الوكيل.

لا يحتاج النموذج أبدًا إلى تفاصيل التنفيذ أو بيانات اعتماد النظام خلف الخادم. يرى تعريفات الأدوات المراجعة. يتولى عميل MCP الاكتشاف والاستدعاءات، بينما يحتفظ الخادم بملكية التحقق، السياسة، والاتصال بنظام مجاله.

وكيل ADK-Rust

يختار قدرة من كتالوج الأدوات المراجعة.

→

عميل MCP

يكتشف المخططات، يرسل الاستدعاءات، ويتلقى المحتوى المطبوع.

→

Loyalty MCP Server

يحقق في الطلب ويمتلك 18 عقود أدوات موثقة.

→

نظام المجال

يحافظ على واجهة برمجة التطبيقات، البيانات، بيانات الاعتماد، وقواعد العمل خلف الخادم.

الاتصال: stdio · إطار عمل الخادم: ADK MCP SDK + rmcp

كتالوج الأدوات

ماذا يمكن للوكيل أن يطلب من Loyalty MCP Server القيام به؟

لكل أداة اسم ثابت، غرض قابل للقراءة من قبل الإنسان، وعقد إدخال JSON يتم اكتشافه أثناء تهيئة MCP. تأتي فئات المخاطر من بيان سجل المشروع عند توفره.

18 أدوات مسماة

enroll_member

تسجيل عضو ولاء جديد

internal write

get_member

الحصول على حساب العضو، المستوى، والأرصدة

read only

find_member

البحث عن أعضاء حسب رقم العضوية أو الاسم

read only

set_member_status

تغيير حالة حساب عضو

internal write

get_balance

الحصول على رصيد النقاط وتقدم المستوى

read only

earn_points

كسب نقاط من الإنفاق (تطبق مضاعفات المستوى والعرض)

internal write

award_points

منح نقاط مباشرة (مكافأة/حسن نية)

internal write

adjust_points

تعديل النقاط يدويًا للأعلى أو الأسفل

internal write

expire_points

انتهاء صلاحية نقاط من رصيد عضو

internal write

get_ledger

الحصول على سجل دفتر نقاط عضو

read only

create_reward

إنشاء مكافأة في الكتالوج

internal write

list_rewards

قائمة المكافآت النشطة (اختياريًا مصفاة حسب المستوى للعضو)

read only

الحوكمة

افهم تأثير كل أداة.

يرث اتصال الخادم سلطة بيانات الاعتماد وبيئة النشر الخاصة به. التصريحات أدناه مأخوذة من ملف README الخاص بهذا المشروع وبيان سجل MCP؛ لا يزال تطبيقك يقرر الأدوات التي يتلقاها الوكيل وأين يتطلب الأمر الموافقة.

11 internal write7 read only

كتابات النقاط مقيدة — earn_points، award_points، adjust_points، expire_points، redeem_reward، و set_redemption_status تتطلب موافقة في الإنتاج (لأنها تحرك نقاط ذات قيمة مالية)؛…
سلامة الرصيد — كل التغييرات تمر عبر دفتر الحسابات؛ لا يمكن أن يصبح الرصيد سالبًا، والإلغاءات تُعكس عبر قيود تعويضية.
لا توجد بيانات شخصية خام — الأعضاء يحملون مرجع اتصال، وليس بالضرورة تفاصيل اتصال خام.
هيكل تكامل — المخزن في الذاكرة للتطوير؛ ادعمه بمخزن دائم واربط الجهات الفاعلة بهويات مصدقة في الإنتاج.

واجهة MCP

ما تعلنه الوثائق الحالية.

يمكن لـ MCP حمل الأدوات، الموارد، المطالبات، النتائج المنظمة، التقدم، الإلغاء، والعمل طويل الأمد. يبرز هذا السجل ميزات البروتوكول الحديثة المذكورة صراحة في هذا المستودع.

الإلغاء

ADK MCP SDKrmcpبيان السجل

التثبيت والاتصال

اتبع نقطة البداية الموثقة للمشروع.

ثبت الخادم في البيئة التي تمتلك بيانات الاعتماد والوصول إلى المجال. أضفه إلى مضيف MCP الخاص بك، تحقق من الأدوات المكتشفة، وقم بتضييق مجموعة الأدوات قبل تسليمها لوكيل الإنتاج.

تثبيت

cargo install mcp-loyalty

شكل اتصال ADK-Rust

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

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

يتم استخراج الأوامر والتكوين من ملف README العام. تحقق من المتطلبات المسبقة، متغيرات البيئة، وخيارات الإصدار المحددة في الوثائق الرسمية قبل النشر.

الوثائق الرسمية

تابع مصدر الحقيقة الخاص بصانعي المشروع.

توفر هذه الصفحة خريطة سهلة الوصول للخادم. يبقى المستودع المرجع الدقيق للمخططات، المتطلبات المسبقة، التكوين، الأمثلة، الاختبارات، الإصدارات، وتحديثات الأمان.

نظرة عامة ↗README.md سجل التغييرات ↗CHANGELOG.md الهيكلية ↗docs/architecture.svg المشكلات والدعم ↗مشكلات github.com

استمر في الاستكشاف

Loyalty MCP Server

قدرة مخصصة خلف اتصال MCP واحد.

كيف يتناسب Loyalty MCP Server مع نظام الوكيل.

وكيل ADK-Rust

عميل MCP

Loyalty MCP Server

نظام المجال

الهيكلية المنشورة للخادم

ماذا يمكن للوكيل أن يطلب من Loyalty MCP Server القيام به؟

افهم تأثير كل أداة.

ما تعلنه الوثائق الحالية.

اتبع نقطة البداية الموثقة للمشروع.

تابع مصدر الحقيقة الخاص بصانعي المشروع.

المزيد في عمليات الأعمال.