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.
Kotlin / JVM
Incorpore o servidor MCP do StackQL em uma aplicação Kotlin ou JVM, como biblioteca ou como plugin do Gradle. O cliente é o SDK oficial do MCP para Kotlin.
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
Adicione a biblioteca io.stackql:stackql-mcp:
dependencies {
implementation("io.stackql:stackql-mcp:0.1.0")
}
Requer o JDK 17 e o Kotlin 2.x. O cliente vem do SDK oficial do MCP para Kotlin.
Início rápido
import io.stackql.mcp.LaunchArgs
import io.stackql.mcp.Mode
import io.stackql.mcp.StackqlMcp
suspend fun main() {
val server = StackqlMcp.builder()
.mode(Mode.ReadOnly)
.auth(LaunchArgs.authFor("github", "null_auth"))
.start()
server.use {
val tools = server.client.listTools().tools
println("${tools.size} tools available")
}
}
A API é composta por StackqlMcp.builder() com .mode(), .auth() e .start(), o enum Mode e LaunchArgs.authFor().
Modos
O builder usa Mode.ReadOnly por padrão. Chame .mode() com Mode.Safe, Mode.DeleteSafe ou Mode.FullAccess para elevar o modo. 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
A biblioteca baixa, verifica e armazena o binário assinado no cache compartilhado em ~/.stackql/mcp-server-bin/, independentemente do diretório de trabalho. O plugin do Gradle conecta a mesma inicialização ao seu build, para que os jobs de CI possam executar consultas do StackQL sem uma etapa de instalação separada.
Aplicativo de demonstração
costgate controla as implantações de infraestrutura com base em orçamentos de custo. Ele é distribuído como CLI e como plugin do Gradle.
Como CLI:
costgate check --intent examples/costgate.yaml --explain
Como plugin do Gradle:
plugins {
id("io.stackql.costgate") version "0.1.0"
}
costgate {
intent.set(layout.projectDirectory.file("costgate.yaml"))
explain.set(true)
}