تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
run_mutation_query
تنفذ جمل INSERT أو UPDATE أو REPLACE أو DELETE على الموفر. آثار جانبية فعلية - يغير الاستدعاء الناجح الحالة السحابية.
يخضع لوضع الخادم:
| الوضع | INSERT / UPDATE / REPLACE | DELETE |
|---|---|---|
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: