MCP

layerx-mcp: دليل البدء بخادم MCP للوصول إلى LayerX agent في Paxeer X

إذا أردت دمج MCP server الخاص بـ LayerX agent من Paxeer X محليًا من الشيفرة المصدرية، فجهّز أولًا سلسلة أدوات Go/C17/Rust ثم ثبّت عبر واجهة سطر الأوامر الرسمية، وإلا ستتعطل خطوة البناء.

Official source · GitHub - Sidiora-Labs/paxeer-monorepo

Install

layerx install mcp

لمن هذا الدليل

  • مناسب للمطورين الذين يريدون دمج قدرات الـ agent داخل منظومة Paxeer X Network: هذا المستودع هو monorepo الخاص بالشبكة، ويحتوي على سلسلة Paxeer X (paxd، بلغة Go، وEVM chain ID 125) ونواة LayerX (layerxd، بلغة C17، ونطاق تنفيذ ومحاسبة حتمي موجّه للوكلاء المستقلين)، إضافة إلى MCP server الموجود في services/agent/crates/layerx-mcp، وأدوات تطوير SDK بلغات Rust وPython وTypeScript.
  • مناسب لمن جهّز بيئة تطوير للبناء من الشيفرة المصدرية: متطلبات سلسلة الأدوات المدرجة رسميًا تشمل Go 1.25.8 (في go.mod)، ومترجم C17 اللازم للنواة، وRust 1.91.1 (في rust-toolchain.toml)، وSolidity 0.8.27 مع Foundry، وNode.js (عبر npm workspaces).
  • غير مناسب لمن يريد فقط تثبيت حزمة MCP مستقلة دون بناء محلي: لا توجد أدلة على توفر أي ملفات ثنائية مُجمّعة مسبقًا أو خدمات مُدارة. أما بالنسبة للنشر على السلسلة أو إدارة الأصول وغيرها من العمليات، فالوثائق الرسمية تنص صراحةً على أن اجتياز التدقيق محليًا لا يمنح تصريحًا بها؛ وبخلاف ذلك لم تُذكر حدود الصلاحيات المحددة في الأدلة المتاحة.

أول محاولة في 3 دقائق

  • المتطلبات المسبقة: جهّز سلسلة الأدوات وفق المتطلبات الرسمية (Go 1.25.8، مترجم C17، Rust 1.91.1، Node.js وغيرها)، واستنسخ المستودع إلى جهازك. ما يلي هو المسار الأكثر مباشرة الوارد في README الرسمي.
  • التثبيت والإعداد: يوفر المستودع واجهة سطر أوامر للمطورين في tools/platform/cli، ويمكن تثبيت نقل MCP عبر الأمر layerx install mcp (وهناك أيضًا layerx install a2a لتثبيت نقل A2A كطريقة ثانوية). هذه الخطوة هي المسار الرئيسي الموصى به رسميًا للإعداد.
  • أول تحقق منخفض المخاطر: من جذر المستودع شغّل make layerxd وmake layerxctl لبناء برنامج LayerX الخفي (daemon) الخاص بالنواة وواجهة سطر الأوامر الخاصة به على التوالي (بينما يبني make paxeer-build الملف build/paxd). مخرجات البناء هي أول إشارة نجاح.
  • إشارة النجاح: ظهور مخرجات بناء النواة وواجهة سطر الأوامر، وبعد اكتمال layerx install mcp يظهر MCP server الخاص بـ LayerX في عميل MCP لديك. ملاحظة: الأدلة لا تتضمن قائمة أوامر فرعية محددة لواجهة سطر الأوامر ولا أمثلة لاستدعاء الأدوات؛ ما يمكن تأكيده هو خطوة "تثبيت النقل + نجاح البناء" فقط. أما تفاصيل الاستدعاء الأعمق فاعتمد على وثائق المستودع نفسه، ولا تخمّن قيم المعاملات بنفسك.
  • تنبيه: جميع الخطوات السابقة هي كتابة على الحالة المحلية (مخرجات التجميع والإعدادات المحلية) وليست عمليات كتابة بعيدة؛ لكن لا تعتبرها "خالية من المخاطر" أيضًا — فحدود الخصوصية المتعلقة بالقراءة والكتابة المحلية والوصول إلى الشبكة لم تُوضَّح في الأدلة.

حالات الاستخدام

  • الحالة الأولى: تثبيت نقل MCP الخاص بـ LayerX agent في عميل MCP لديك. نفّذ الأمر layerx install mcp من واجهة سطر الأوامر في tools/platform/cli، وبعد الانتهاء تحقق في عميل MCP الذي أعددته من ظهور هذا الخادم وقائمة أدواته. الأدلة تدعم فقط تأكيد "تم تثبيت النقل وظهور الخادم"؛ أما أسماء الأدوات والمعاملات المحددة فلم تدرجها الوثائق الرسمية ضمن الأدلة المعتمدة، فاعتمد على المخرجات الفعلية في وثائق المستودع.
  • الحالة الثانية: بناء النواة وسلسلة أدوات التشغيل للتطوير المحلي. بعد استنساخ المستودع، شغّل من الجذر make layerxd وmake layerxctl للحصول على برنامج LayerX الخفي (daemon) الخاص بالنواة وواجهة سطر الأوامر الخاصة به؛ وإذا أردت أيضًا بناء عقدة السلسلة، شغّل make paxeer-build للحصول على build/paxd. النتيجة المتوقعة هي أن تنجح أوامر البناء في إنتاج الملفات الثنائية المقابلة. أما الإجراءات التي تتضمن نشرًا حقيقيًا أو أصولًا فتقع خارج هذا النطاق.

حدود الاستخدام

  • البناء والإعداد المحلي كتابة على الحالة المحلية؛ وmake public-audit (أي scripts/ci/public-repo-audit.sh) فحص يجب اجتيازه مع كل تغيير، لكن الوثائق الرسمية تنص صراحةً على أن اجتياز التدقيق محليًا لا يعني التصريح بنشر العقود أو نقل الأصول المودعة أو التعامل مع أصول حقيقية — أي عملية كتابة بعيدة من هذا النوع تتطلب مسار تأكيد رسمي إضافيًا، ولم تُقدَّم تفاصيل هذا المسار في الأدلة.
  • متطلبات الإعداد المتعلقة ببيانات الاعتماد والمحافظ ومفاتيح API لم تُذكر في الأدلة المعتمدة؛ فلا تقدّم معلومات حساسة مسبقًا في المحاولة الأولى، وعند الحاجة الفعلية اعتمد على الوثائق الرسمية.
  • معلومات أساسية لم يتم تأكيدها بعد: قائمة الأدوات والمعاملات التي يكشفها MCP server، ومنفذ التشغيل، ونطاق توافق العملاء، وحدود الخصوصية والاتصال بالشبكة للأدوات للقراءة فقط — لم يظهر أي منها في الأدلة، فتحقق منها مباشرة من وثائق المستودع قبل الاستخدام.
  • حتى لو وُجدت أدوات للقراءة فقط من نوع readOnlyHint، فإن ذلك يعني فقط أنها لا تنفذ عمليات كتابة، ولا يعني أنها لن تتصل بالشبكة أو تقرأ بيانات محلية؛ فلا تبنِ على ذلك استنتاجًا شاملًا بشأن الأمان.