翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何在 Go 應用程式中內嵌 StackQL MCP 伺服器
StackQL 的 MCP 伺服器可以在編譯後的 Go 程式內執行,不需要 npx、無需另外安裝,也沒有執行階段相依性。stackql-mcp-go 程式庫會在官方 Go MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,讓您的 Go 應用程式取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。這正是 sandboxctl 背後的模式,它是以單一二進位檔發行的隨需基礎架構管家。
步驟
- 新增程式庫:
go get github.com/stackql/stackql-mcp-go
- 啟動內嵌伺服器並呼叫工具。伺服器預設以
read_only模式啟動:
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
}
- 選擇模式。
Options.Mode預設為read_only。只有在應用程式需要佈建時,才將它設為safe、delete_safe或full_access。權限提升需明確指定。
使用 go:embed 發行單一二進位檔
若要產生獨立式可執行檔,請新增一個 go:generate 擷取步驟,下載該平台的二進位檔並進行 sha256 驗證,然後以 go:embed 將它內嵌到建置中:
//go:generate go run github.com/stackql/stackql-mcp-go/cmd/stackql-mcp-fetch -platform auto -package main
在執行階段,StackqlMCPBinary() 會傳回內嵌的二進位檔,因此首次執行時不需下載。若不使用 vendoring,二進位檔會在首次執行時下載到位於 ~/.stackql/mcp-server-bin/ 的共用快取並進行驗證。
示範應用程式
sandboxctl 是一個基礎架構管家:在單一 Go 二進位檔中結合內嵌的 StackQL MCP 伺服器與 Claude 代理程式迴圈,負責規劃臨時雲端沙箱並檢查成本,取得核准後才佈建。
相關概念
- 內嵌式 MCP:Go 參考:安裝、API 與模式
- 如何搭配 AI 代理程式使用 StackQL:MCP 模型與安全模式
- StackQL MCP 架構:傳輸方式、模式與稽核內部機制
- 什麼是代理式基礎架構?:此做法促成的模式