إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

run_mutation_query

تنفذ جمل INSERT أو UPDATE أو REPLACE أو DELETE على الموفر. آثار جانبية فعلية - يغير الاستدعاء الناجح الحالة السحابية.

يخضع لوضع الخادم:

الوضعINSERT / UPDATE / REPLACEDELETE
read_onlyمرفوضمرفوض
safe (افتراضي)يتطلب موافقة (elicitation)يتطلب موافقة
delete_safeمسموحيتطلب موافقة
full_accessمسموحمسموح

معلومات

تخضع الحمولة التي تحتوي على عدة جمل للجملة ذات الامتيازات الأعلى فيها

عندما تتطلب عملية تعديل البيانات موافقة ولم يعلن العميل عن قدرة elicitation في MCP، يتم رفض الاستدعاء.

راجع أيضًا: [ نظرة عامة على MCP ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT في مواصفات اللغة ] [ DELETE في مواصفات اللغة ]


الإدخالات​

الوسيطةمطلوبالوصف
sqlنعمجملة INSERT أو UPDATE أو REPLACE أو DELETE.
sourceلامعرف إدخال Query Library عندما يأتي SQL من query_library_get. للإشارة إلى المصدر فقط؛ لا يغير التنفيذ ولا الموافقات.
formatلاتنسيق عرض النص: markdown أو json. عند حذفها، تستخدم الأداة إعداد العرض الخاص بالخادم.

الإخراج​

أداة العرضالشكل
KV{messages: [...], timestamp} - تأكيد الإرسال، وليس نص استجابة واجهة API

مثال​

جرّب هذا الموجه مع أي عميل MCP يدعم elicitation ومسجل فيه خادم StackQL MCP:

The firewall rule allow-test-old in project my-project
is no longer needed. Please remove it.

سيعرض عميل MCP طلب موافقة قبل إرسال عملية الحذف، ما لم يكن الخادم يعمل في الوضع full_access.

يوضح المقطع التالي تدفق elicitation عندما يعمل خادم StackQL MCP في الوضع الافتراضي safe - إذ يُطلب من العميل الموافقة على جملة DELETE قبل إرسال أي تغيير على جانب السحابة. يمكنك إعادة إنتاج ذلك على خادم StackQL MCP الخاص بك باستخدام MCP Inspector الرسمي عبر npx @modelcontextprotocol/inspector: