Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.
Kotlin / JVM
Nhúng máy chủ MCP StackQL vào một ứng dụng Kotlin hoặc JVM, dưới dạng thư viện hoặc plugin Gradle. Ứng dụng khách là SDK MCP chính thức cho Kotlin.
Tệp nhị phân nhúng được tải xuống và xác minh sha256 trong lần chạy đầu tiên, hoặc được đưa vào ứng dụng của bạn theo kiểu vendoring. Xem hợp đồng chung.
Cài đặt
Thêm thư viện io.stackql:stackql-mcp:
dependencies {
implementation("io.stackql:stackql-mcp:0.1.0")
}
Yêu cầu JDK 17 và Kotlin 2.x. Ứng dụng khách đến từ SDK MCP chính thức cho Kotlin.
Bắt đầu nhanh
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 gồm StackqlMcp.builder() với .mode(), .auth() và .start(), enum Mode và LaunchArgs.authFor().
Chế độ
Builder mặc định dùng Mode.ReadOnly. Gọi .mode() với Mode.Safe, Mode.DeleteSafe hoặc Mode.FullAccess để nâng mức quyền. Việc nâng mức quyền phải được thực hiện một cách rõ ràng - máy chủ sẽ không bật các công cụ thay đổi dữ liệu hoặc công cụ vòng đời trừ khi bạn chủ động bật.
Vendoring / nhúng
Thư viện tải xuống, xác minh và lưu tệp nhị phân đã ký vào cache dùng chung tại ~/.stackql/mcp-server-bin/, không phụ thuộc vào thư mục làm việc. Plugin Gradle đưa cùng cơ chế khởi chạy đó vào bản dựng của bạn, nhờ vậy các tác vụ CI có thể chạy truy vấn StackQL mà không cần bước cài đặt riêng.
Ứng dụng minh họa
costgate kiểm soát việc triển khai hạ tầng dựa trên ngân sách chi phí. Ứng dụng được phát hành cả dưới dạng CLI lẫn dưới dạng plugin Gradle.
Dưới dạng CLI:
costgate check --intent examples/costgate.yaml --explain
Dưới dạng plugin Gradle:
plugins {
id("io.stackql.costgate") version "0.1.0"
}
costgate {
intent.set(layout.projectDirectory.file("costgate.yaml"))
explain.set(true)
}