Zum Hauptinhalt springen
Übersetzte Seite

Diese Seite wurde mit KI-Unterstützung aus dem Englischen übersetzt. Bei Abweichungen ist die englische Version maßgeblich.

Gleam

Betten Sie den StackQL-MCP-Server in eine Gleam-Anwendung auf dem Erlang/BEAM-Target ein. Die Bibliothek integriert sich in die OTP-Supervision, lädt die signierte Binärdatei herunter, verifiziert sie und startet sie über stdio.

info

Die eingebettete Binärdatei wird beim ersten Start heruntergeladen und per sha256 verifiziert oder per Vendoring in Ihre App eingebunden. Siehe den gemeinsamen Vertrag.

Installation​

gleam add stackql_mcp

Unterstützt nur das Erlang/BEAM-Target (nicht das JavaScript-Target). Der Server wird über child_spec() als OTP-Child bereitgestellt, sodass er in Ihrem eigenen Supervision-Tree laufen kann.

Schnellstart​

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)
}

Die API besteht aus stackql_mcp.start(), stop() und child_spec() für den Lebenszyklus, list_tools() und call_tool() für Operationen (mit den Varianten supervised_list_tools() und supervised_call_tool() für den Einsatz unter einem Supervisor) sowie Config, default_config() und auth_for() für die Konfiguration.

Modi​

Der Modus wird über Config.mode gesetzt und ist standardmäßig read_only. Setzen Sie ihn auf safe, delete_safe oder full_access, um zu eskalieren:

stackql_mcp.Config(..stackql_mcp.default_config(), mode: stackql_mcp.safe)

Die Eskalation ist explizit - der Server aktiviert keine Mutations- oder Lifecycle-Tools, sofern Sie sich nicht ausdrücklich dafür entscheiden.

Vendoring / Einbetten​

Beim Start lädt die Bibliothek das StackQL-Bundle für die Plattform herunter, verifiziert es gegen eingebaute sha256-Pins und legt es im gemeinsamen Cache der Bibliotheksfamilie ab. Auflösungsreihenfolge:

  1. Explizites Config.binary.
  2. Umgebungsvariable STACKQL_MCP_BIN.
  3. Gemeinsamer Cache unter ~/.stackql/mcp-server-bin/<version>/<platform-key>/.

Für Offline- oder Air-Gapped-Deployments setzen Sie STACKQL_MCP_BUNDLE auf ein lokales Bundle.

Demo-App​

pipewatch ist die geplante Demo für diese Bibliothek. Sie steht auf der Roadmap und ist noch nicht implementiert.

github.com/stackql/stackql-mcp-gleam