翻譯頁面
本頁面由英文在 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 成本關卡。
步驟
- 新增程式庫至您的 Gradle 相依性:
dependencies {
implementation("io.stackql:stackql-mcp:0.1.0")
}
需要 JDK 17 與 Kotlin 2.x。用戶端來自官方的 Kotlin MCP SDK。
- 啟動伺服器並列出工具。建立器預設為
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")
}
}
- 選擇模式。
.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)
}
相關概念
- 內嵌式 MCP:Kotlin / JVM 參考:安裝、API 與 Gradle 外掛程式
- 如何搭配 AI 代理程式使用 StackQL:MCP 模型與安全模式
- StackQL MCP 架構:傳輸方式、模式與稽核內部機制
- 什麼是代理式基礎架構?:此做法促成的模式