Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

Kotlin / JVM

Вбудуйте сервер MCP StackQL у застосунок Kotlin або JVM як бібліотеку чи плагін Gradle. Клієнт - офіційний SDK MCP для Kotlin.

інформація

Вбудований двійковий файл завантажується й перевіряється за sha256 під час першого запуску або включається у ваш застосунок через вендоринг. Див. Спільний контракт.


Встановлення​

Додайте бібліотеку io.stackql:stackql-mcp:

dependencies {
implementation("io.stackql:stackql-mcp:0.1.0")
}

Потрібні JDK 17 і Kotlin 2.x. Клієнт надає офіційний SDK MCP для Kotlin.


Швидкий старт​

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")
}
}

API складається з StackqlMcp.builder() з методами .mode(), .auth() і .start(), переліку Mode і LaunchArgs.authFor().


Режими​

За замовчуванням будівельник використовує Mode.ReadOnly. Щоб підвищити рівень доступу, викличте .mode() зі значенням Mode.Safe, Mode.DeleteSafe або Mode.FullAccess. Підвищення рівня доступу завжди явне - сервер не вмикає інструменти змінення даних і життєвого циклу, якщо ви явно їх не ввімкнете.


Вендоринг / вбудовування​

Бібліотека завантажує, перевіряє й кешує підписаний двійковий файл у спільному кеші в каталозі ~/.stackql/mcp-server-bin/ незалежно від робочого каталогу. Плагін Gradle підключає такий самий запуск до вашої збірки, тож завдання CI можуть виконувати запити StackQL без окремого кроку встановлення.


Демонстраційний застосунок​

costgate контролює розгортання інфраструктури на основі бюджетів витрат. Застосунок доступний і як CLI, і як плагін Gradle.

Як CLI:

costgate check --intent examples/costgate.yaml --explain

Як плагін Gradle:

plugins {
id("io.stackql.costgate") version "0.1.0"
}

costgate {
intent.set(layout.projectDirectory.file("costgate.yaml"))
explain.set(true)
}

github.com/stackql/stackql-mcp-kotlin