跳至主要內容
翻譯頁面

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

如何在 Gleam 應用程式中內嵌 StackQL MCP 伺服器

StackQL 的 MCP 伺服器可以在以 Erlang/BEAM 為目標的 Gleam 應用程式內執行,無需另外安裝,也沒有執行階段相依性。stackql_mcp 程式庫會透過 stdio 啟動已簽署的 StackQL 二進位檔,並與 OTP 監督機制整合,讓 BEAM 服務取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。伺服器透過 child_spec() 公開為 OTP 子處理程序,因此可以放在您自己的監督樹中。

步驟​

  1. 新增程式庫:
gleam add stackql_mcp

僅以 Erlang/BEAM 為目標(不含 JavaScript 目標)。

  1. 啟動伺服器並列出工具。Config.mode 預設為 read_only:
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)
}

使用 child_spec() 將伺服器放在監督器下,並使用 supervised_list_tools() 與 supervised_call_tool() 進行受監督的呼叫。

  1. 選擇模式。Config.mode 預設為 read_only。建立 stackql_mcp.Config(..stackql_mcp.default_config(), mode: stackql_mcp.safe) 即可提升至 safe、delete_safe 或 full_access。權限提升需明確指定。

二進位檔來源​

啟動時,程式庫會下載該平台的 StackQL 安裝套件,以內建的 sha256 釘選值進行驗證,並快取於程式庫系列共用的快取中。解析優先順序:明確指定的 Config.binary,其次是 STACKQL_MCP_BIN,然後是位於 ~/.stackql/mcp-server-bin/ 的共用快取。對於離線或實體隔離的部署,請將 STACKQL_MCP_BUNDLE 設為指向本機安裝套件。

示範應用程式​

pipewatch 是此程式庫規劃中的示範應用程式。它已列入開發藍圖,但尚未實作。