본문으로 건너뛰기
번역된 페이지

이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.

Kotlin / JVM

StackQL MCP 서버를 라이브러리 또는 Gradle 플러그인으로 Kotlin 또는 JVM 애플리케이션에 내장합니다. 클라이언트는 공식 Kotlin MCP SDK입니다.

정보

임베디드 바이너리는 첫 실행 시 다운로드되어 sha256으로 검증되거나, 앱에 벤더링됩니다. 공통 계약을 참조하세요.


설치​

io.stackql:stackql-mcp 라이브러리를 추가합니다:

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

JDK 17 및 Kotlin 2.x가 필요합니다. 클라이언트는 공식 Kotlin MCP SDK에서 제공됩니다.


빠른 시작​

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.Safe, Mode.DeleteSafe 또는 Mode.FullAccess 값으로 .mode() 메서드를 호출하세요. 승격은 명시적입니다. 옵트인하지 않으면 서버는 변경 작업 도구나 수명 주기 도구를 활성화하지 않습니다.


벤더링 / 내장​

라이브러리는 작업 디렉터리와 관계없이 서명된 바이너리를 다운로드하고 검증한 다음 ~/.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