Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

Go

Incorpore o servidor MCP do StackQL em uma aplicação Go compilada, seja como um sidecar baixado, seja incluído no seu binário por vendoring com go:embed. O cliente é o SDK oficial do MCP para Go.

informação

O binário incorporado é baixado e verificado com sha256 na primeira execução, ou incluído na sua aplicação por vendoring. Consulte o contrato comum.


Instalação​

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

Início rápido​

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
}

A API é StartServer(ctx, Options{Binary, Mode}); o cliente retornado vem do SDK oficial do MCP para Go.


Modos​

O servidor inicia no modo read_only por padrão. Defina Options.Mode para elevar o modo para safe, delete_safe ou full_access. A elevação é explícita - o servidor não habilita as ferramentas de mutação nem as de ciclo de vida, a menos que você as ative explicitamente.


Vendoring / incorporação​

Faça o vendoring do binário com go:embed por meio de uma etapa de busca com go:generate, gerando um único executável autocontido:

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

A etapa de busca baixa o binário assinado da plataforma de destino, o verifica com sha256 e o grava onde o go:embed pode incluí-lo no seu build. Em tempo de execução, StackqlMCPBinary() retorna o binário incorporado, então não há download na primeira execução.


Aplicativo de demonstração​

sandboxctl é um concierge de infraestrutura: um servidor incorporado e um loop de agente do Claude em um único binário que planeja, verifica o custo e provisiona sandboxes efêmeros na nuvem, sujeitos a uma etapa de aprovação.


github.com/stackql/stackql-mcp-go