بوابة القرار CLI
بوابة القرار CLI هي واجهة الأوامر الموجهة للمستخدم لعمليات خادم MCP، أدوات عميل MCP، سير عمل runpack، أدوات التأليف، ومساعدي السجل/المستندات. وهي جزء من مستودع Decision Gate OSS وتأتي مع الحزم الأساسية.
ما يغطيه
- تشغيل خادم MCP مع تكوين محلي.
- التحقق من التكوين، وتأليف المدخلات، وrunpack artifacts.
- وصول عميل MCP إلى الأدوات والموارد عبر HTTP أو SSE أو stdio.
- اكتشاف المزود وعمليات تسجيل المخطط.
- البحث في الوثائق وقراءة الموارد عبر MCP.
- تقييم التوافق لأدوات الفحص من البداية إلى النهاية.
- أغطية توليد/تحقق العقد وSDK.
الشكل الحالي (اعتبارًا من 1 فبراير 2026)
أسماء الأوامر والمجموعات مستقرة وتغطي كامل سطح أداة MCP بالإضافة إلى تغليفات العقد وSDK. استخدم decision-gate --help لرؤية العلامات المحددة للنسخة الرسمية.
سير العمل السريع
الخدمة مع إعداد مسبق
decision-gate serve --config configs/presets/default-recommended.toml
لتطوير محلي بدون ثنائي مسبق البناء:
cargo run -p decision-gate-cli -- serve --config configs/presets/default-recommended.toml
تحقق أو تطبيع مدخلات التأليف
decision-gate authoring validate --input examples/scenario.ron --format ron
decision-gate authoring normalize --input examples/scenario.ron --format ron \
--output examples/scenario.json
تصدير Runpack والتحقق منه
decision-gate runpack export --help
decision-gate runpack verify --help
فحص أدوات ومستندات MCP
decision-gate mcp tools list --transport http --endpoint http://127.0.0.1:8080/rpc
decision-gate docs search --transport http --endpoint http://127.0.0.1:8080/rpc --query "runpack"
واجهة الأوامر (ملخص)
| المنطقة | الأمر | الغرض |
|---|---|---|
| الخادم | serve | تشغيل خادم Decision Gate MCP من تكوين. |
| التكوين | config validate | التحقق من صحة decision-gate.toml والخروج بحالة. |
| التأليف | authoring validate | التحقق من صحة مدخلات ScenarioSpec (RON/JSON). |
| التأليف | authoring normalize | تطبيع إلى JSON قياسي (RFC 8785). |
| حزم التشغيل | runpack export | تصدير حزمة تشغيل للاستخدام غير المتصل. |
| حزم التشغيل | runpack verify | التحقق من سلامة حزمة التشغيل غير المتصل. |
| المزودون | provider list | قائمة بالمزودين والتأكد من تكوينهم. |
| المزودون | provider contract get | جلب عقد المزود بصيغة JSON. |
| المزودون | provider check-schema get | جلب بيانات التعريف لهيكل التحقق من المزود. |
| المخططات | schema register | تسجيل سجل مخطط. |
| المخططات | schema list | قائمة بالمخططات لمستأجر/مساحة اسم. |
| المخططات | schema get | جلب المخطط بواسطة id/الإصدار. |
| الوثائق | docs search | البحث في أقسام الوثائق. |
| الوثائق | docs list | قائمة بمصادر الوثائق. |
| الوثائق | docs read | قراءة URI لمصدر الوثائق. |
| التفاعل | interop eval | تقييم تشغيل التفاعل ضد خادم MCP. |
| أدوات MCP | mcp tools list | قائمة بتعريفات أدوات MCP. |
| أدوات MCP | mcp tools call | استدعاء أداة MCP بالاسم. |
| موارد MCP | mcp resources list | قائمة بموارد MCP. |
| موارد MCP | mcp resources read | قراءة مورد MCP بواسطة URI. |
| أدوات MCP المخصصة | mcp tool <tool> | غلاف مخصص لكل أداة MCP. |
| العقد | contract generate | إنشاء مخرجات العقد. |
| العقد | contract check | التحقق من مخرجات العقد. |
| SDK | sdk generate | إنشاء مخرجات SDK/OpenAPI. |
| SDK | sdk check | التحقق من مخرجات SDK/OpenAPI. |
خيارات عميل MCP
--transport http|sse|stdioيحدد وسيلة نقل MCP.--endpointيحدد عنوان URL لـ HTTP/SSE؛--stdio-commandبالإضافة إلى المعلمات/البيئة يقوم بتكوين stdio.--bearer-token،--client-subject،--auth-profile، و--auth-configتتحكم في المصادقة.--jsonأو--inputيزود الحمولة للأداة؛--no-validateيتجاوز فحوصات المخطط.
أغلفة أدوات MCP المخصصة
استخدم decision-gate mcp tool <name> لتغليفات مكتوبة عبر كامل واجهة الأداة:
- Scenario lifecycle:
scenario-define,scenario-start,scenario-status,scenario-next, دورة حياة السيناريو:scenario-define,scenario-start,scenario-status,scenario-next,scenario-submit,scenario-trigger,scenarios-list - الأدلة وحزم التشغيل:
evidence-query,runpack-export,runpack-verify,precheck - Providers and schemas:
providers-list,provider-contract-get,provider-check-schema-get, مقدمو الخدمة والمخططات:providers-list,provider-contract-get,provider-check-schema-get,schemas-register,schemas-list,schemas-get - الوثائق:
decision-gate-docs-search
اختيار اللغة
تُشحن كتالوجات CLI الحالية للغات EN (الإنجليزية) وCA (الكتالونية)، مع خطط لإضافة لغات أخرى. استخدم --lang en|ca أو قم بتعيين DECISION_GATE_LANG. يُصدر الإخراج غير الإنجليزي إخلاء مسؤولية عن الترجمة الآلية.
نموذج السلامة والحواجز الأمنية
- يتم التحقق من المدخلات وتفشل في حالة حدوث أخطاء.
- يتم تحديد حجم قراءات الملفات وحمولات MCP لتجنب استنفاد الحمولات غير الموثوقة.
- مدخلات أداة MCP يتم التحقق من صحتها وفقًا للمخطط بشكل افتراضي (استخدم
--no-validateفقط عند الحاجة). - تتطلب روابط HTTP/SSE غير المرتجعة اختيارًا صريحًا من واجهة سطر الأوامر بالإضافة إلى TLS والمصادقة غير المحلية.
- الإخراجات القابلة للقراءة آليًا تكون افتراضيًا بتنسيق JSON القياسي؛ توفر الأوامر المحددة تنسيقات نصية/Markdown.