跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

run_mutation_query

對 Provider 執行 INSERT、UPDATE、REPLACE 或 DELETE。會產生實際的副作用:成功的呼叫會變更雲端狀態。

由伺服器模式管控:

模式INSERT / UPDATE / REPLACEDELETE
read_only拒絕拒絕
safe(預設)需要核准(徵詢)需要核准
delete_safe允許需要核准
full_access允許允許

資訊

包含多個陳述式的承載,會依其中權限最高的陳述式進行管控

變更需要核准且用戶端未宣告 MCP 徵詢(elicitation)功能時,呼叫會遭到拒絕。

另請參閱: [ MCP 概觀 ] [ run_lifecycle_operation ] [ describe_method ] [ INSERT 語言規格 ] [ DELETE 語言規格 ]


輸入​

引數必要描述
sql是INSERT、UPDATE、REPLACE 或 DELETE 陳述式。
source否SQL 來自 query_library_get 時的 Query Library 項目 ID。僅用於標示出處;不會改變執行方式或核准。
format否文字轉譯格式:markdown 或 json。省略時,會使用伺服器的轉譯設定。

輸出​

轉譯器結構
KV{messages: [...], timestamp}:分派確認,而非 API 回應本文

範例​

請在任何支援徵詢且已註冊 StackQL MCP 伺服器的 MCP 用戶端中試用以下提示詞:

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

除非伺服器以 full_access 模式執行,否則 MCP 用戶端會在分派刪除之前顯示核准要求。

下列短片展示 StackQL MCP 伺服器以預設 safe 模式執行時的徵詢流程:在分派任何雲端側變更之前,用戶端會收到核准 DELETE 的要求。您可以使用官方的 MCP Inspector,透過 npx @modelcontextprotocol/inspector 對您自己的 StackQL MCP 伺服器重現此流程: