跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何在 Kotlin 或 JVM 應用程式中內嵌 StackQL MCP 伺服器

StackQL 的 MCP 伺服器可以在 Kotlin 或 JVM 應用程式內執行,不需要 npx、無需另外安裝,也沒有執行階段相依性。io.stackql:stackql-mcp 程式庫會在官方 Kotlin MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,而配套的 Gradle 外掛程式則將同樣的啟動流程接入建置。這正是 costgate 背後的模式,它是以 CLI 和 Gradle 外掛程式形式發行的 CI/CD 成本關卡。

步驟​

  1. 新增程式庫至您的 Gradle 相依性:
dependencies {
implementation("io.stackql:stackql-mcp:0.1.0")
}

需要 JDK 17 與 Kotlin 2.x。用戶端來自官方的 Kotlin MCP SDK。

  1. 啟動伺服器並列出工具。建立器預設為 Mode.ReadOnly:
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")
}
}
  1. 選擇模式。.mode() 預設為 Mode.ReadOnly。只有在應用程式需要佈建時,才設定 Mode.Safe、Mode.DeleteSafe 或 Mode.FullAccess。權限提升需明確指定。

從 Gradle 建置執行 StackQL 查詢​

Gradle 外掛程式會將內嵌伺服器接入您的建置,讓 CI 工作無需額外的安裝步驟即可執行 StackQL 查詢。costgate 示範會依成本預算管控基礎架構部署,可作為 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)
}