Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
Gleam
Sematkan server MCP StackQL di aplikasi Gleam pada target Erlang/BEAM. Library ini terintegrasi dengan supervisi OTP, mengunduh dan memverifikasi biner yang ditandatangani, lalu menjalankannya melalui stdio.
Biner tersemat diunduh dan diverifikasi dengan sha256 saat pertama kali dijalankan, atau disertakan dalam aplikasi Anda melalui vendoring. Lihat kontrak umum.
Instalasi
gleam add stackql_mcp
Hanya menargetkan Erlang/BEAM (bukan target JavaScript). Server diekspos sebagai proses anak OTP melalui child_spec() sehingga dapat ditempatkan di dalam pohon supervisi Anda sendiri.
Mulai cepat
import gleam/io
import gleam/int
import gleam/list
import envoy
import stackql_mcp
pub fn main() {
let config =
stackql_mcp.Config(
..stackql_mcp.default_config(),
auth: [stackql_mcp.auth_for("github", "null_auth")],
)
let assert Ok(server) =
stackql_mcp.start(
config: config,
home: "/home/u",
os: "linux",
arch: "x86_64",
getenv: envoy.get,
)
let assert Ok(tools) = stackql_mcp.list_tools(server)
io.println(int.to_string(list.length(tools)) <> " tools available")
stackql_mcp.stop(server)
}
API library ini terdiri atas stackql_mcp.start(), stop(), dan child_spec() untuk siklus hidup; list_tools() dan call_tool() untuk operasi (dengan varian supervised_list_tools() dan supervised_call_tool() untuk digunakan di bawah supervisor); serta Config, default_config(), dan auth_for() untuk konfigurasi.
Mode
Mode diatur di Config.mode dengan nilai default read_only. Atur ke safe, delete_safe, atau full_access untuk melakukan eskalasi:
stackql_mcp.Config(..stackql_mcp.default_config(), mode: stackql_mcp.safe)
Eskalasi bersifat eksplisit - server tidak akan mengaktifkan alat mutasi atau siklus hidup kecuali Anda mengaktifkannya secara eksplisit.
Vendoring / penyematan
Saat dimulai, library ini mengunduh bundle StackQL untuk platform tersebut, memverifikasinya terhadap nilai sha256 terkunci yang disertakan di dalam library, lalu menyimpannya di cache bersama keluarga library ini. Urutan prioritas resolusi:
Config.binaryyang ditetapkan secara eksplisit.- Variabel lingkungan
STACKQL_MCP_BIN. - Cache bersama di
~/.stackql/mcp-server-bin/<version>/<platform-key>/.
Untuk deployment offline atau air-gapped, atur STACKQL_MCP_BUNDLE agar mengarah ke bundle lokal.
Aplikasi demo
pipewatch adalah demo yang direncanakan untuk library ini. Demo ini ada dalam peta jalan dan belum diimplementasikan.