跳至主要內容
翻譯頁面

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

如何搭配 Claude 使用 StackQL

Claude 透過 Model Context Protocol 連線到 StackQL:在 Claude Desktop(或 Claude Code)中將 stackql 註冊為 MCP 伺服器後,Claude 就能以自然語言驅動,對 StackQL 支援的每個 Provider 盤點及稽核雲端資源,並在您核准後修改這些資源。

步驟​

  1. 安裝 StackQL,並確認它位於您的 PATH 中:
stackql --version
  1. 編輯 Claude Desktop 設定檔:
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  1. 新增伺服器項目,包括您所使用 Provider 的憑證:
{
"mcpServers": {
"stackql": {
"command": "stackql",
"args": [
"mcp",
"--mcp.server.type=stdio",
"--mcp.config",
"{\"server\": {\"transport\": \"stdio\", \"mode\": \"safe\"}}"
],
"env": {
"AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
"AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key",
"STACKQL_GITHUB_USERNAME": "your-github-username",
"STACKQL_GITHUB_PASSWORD": "your-github-personal-access-token"
}
}
}
}

只需包含您需要的 Provider(Azure 使用 AZURE_TENANT_ID/AZURE_CLIENT_ID/AZURE_CLIENT_SECRET,Google Cloud 使用 GOOGLE_CREDENTIALS,Databricks 使用 DATABRICKS_CLIENT_ID/DATABRICKS_CLIENT_SECRET)。切勿將此檔案提交至版本控制。

  1. 重新啟動 Claude Desktop。對話開始時,伺服器會自動啟動。

  2. 以自然語言提問。以下範例可直接對應到 StackQL 作業:

  • 「列出 us-east-1 中所有具有公用 IP 位址的 EC2 執行個體」
  • 「我們的 GitHub 組織中,哪些存放庫停用了分支保護?」
  • 「在 us-west-2 建立名為 analytics-data 的 S3 儲存貯體」

對於讀取,Claude 會探索 schema 並立即執行 SELECT 陳述式。對於建立儲存貯體,safe 模式會在任何作業執行之前觸發核准要求,顯示確切的 INSERT。

控制 Claude 可以執行的作業​

設定中的 mode 欄位就是契約:read_only 適用於僅限資源清單的助理,safe(預設)適用於需經核准的變更,delete_safe 允許建立與更新但管控刪除,full_access 僅適用於受信任的自動化。無論模式為何,Claude 進行的每次呼叫都會記錄在伺服器的 JSONL 稽核記錄中。