跳至主要內容
翻譯頁面

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

Go

在編譯式 Go 應用程式中內嵌 StackQL MCP 伺服器,可以是下載的 sidecar,也可以使用 go:embed 透過 vendoring 納入您的二進位檔。用戶端是官方的 Go MCP SDK。

資訊

內嵌的二進位檔會在首次執行時下載並經過 sha256 驗證,或透過 vendoring 納入您的應用程式。請參閱共同契約。


安裝​

go get github.com/stackql/stackql-mcp-go

快速入門​

import (
"context"
"github.com/modelcontextprotocol/go-sdk/mcp"
stackqlmcp "github.com/stackql/stackql-mcp-go/embed"
)

func main() {
ctx := context.Background()
client, err := stackqlmcp.StartServer(ctx, stackqlmcp.Options{
Binary: StackqlMCPBinary(),
})
if err != nil {
// handle error
}
defer client.Close()

res, err := client.Session.CallTool(ctx, &mcp.CallToolParams{
Name: "run_select_query",
Arguments: map[string]any{"sql": "SELECT name FROM google.compute.regions WHERE project = 'my-project'"},
})
_ = res
}

API 為 StartServer(ctx, Options{Binary, Mode});傳回的用戶端來自官方的 Go MCP SDK。


模式​

伺服器預設以 read_only 模式啟動。設定 Options.Mode 即可提升至 safe、delete_safe 或 full_access。權限提升必須明確指定:除非您選擇加入,否則伺服器不會啟用變更或生命週期工具。


Vendoring / 內嵌​

使用 go:embed 搭配 go:generate 擷取步驟來 vendor 二進位檔,產生單一的獨立可執行檔:

//go:generate go run github.com/stackql/stackql-mcp-go/cmd/stackql-mcp-fetch -platform auto -package main

擷取步驟會下載目標平台的已簽署二進位檔並進行 sha256 驗證,然後將其寫入 go:embed 能納入建置的位置。在執行階段,StackqlMCPBinary() 會傳回內嵌的二進位檔,因此首次執行時不需要下載。


示範應用程式​

sandboxctl 是一個基礎架構管家:在單一二進位檔中結合內嵌的伺服器與 Claude 代理程式迴圈,負責規劃臨時雲端沙箱、檢查其成本,並在通過核准關卡後加以佈建。


github.com/stackql/stackql-mcp-go