翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
Gleam
在以 Erlang/BEAM 為目標的 Gleam 應用程式中內嵌 StackQL MCP 伺服器。此程式庫與 OTP 監督機制整合,會下載並驗證已簽署的二進位檔,再透過 stdio 啟動它。
資訊
內嵌的二進位檔會在首次執行時下載並經過 sha256 驗證,或透過 vendoring 納入您的應用程式。請參閱共同契約。
安裝
gleam add stackql_mcp
僅以 Erlang/BEAM 為目標(而非 JavaScript 目標)。伺服器透過 child_spec() 公開為 OTP 子項目,因此可以放在您自己的監督樹中。
快速入門
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 包括用於生命週期的 stackql_mcp.start()、stop() 與 child_spec();用於作業的 list_tools() 與 call_tool()(另有在監督器下使用的 supervised_list_tools() 與 supervised_call_tool() 變體);以及用於設定的 Config、default_config() 與 auth_for()。
模式
模式透過 Config.mode 設定,預設為 read_only。若要提升權限,請將其設為 safe、delete_safe 或 full_access:
stackql_mcp.Config(..stackql_mcp.default_config(), mode: stackql_mcp.safe)
權限提升必須明確指定:除非您選擇加入,否則伺服器不會啟用變更或生命週期工具。
Vendoring / 內嵌
啟動時,程式庫會下載該平台的 StackQL 安裝套件,依據內建的 sha256 釘選值進行驗證,並快取在程式庫系列共用的快取中。解析優先順序:
- 明確指定的
Config.binary。 STACKQL_MCP_BIN環境變數。- 位於
~/.stackql/mcp-server-bin/<version>/<platform-key>/的共用快取。
若為離線或實體隔離的部署,請將 STACKQL_MCP_BUNDLE 設為指向本機的安裝套件。
示範應用程式
pipewatch 是此程式庫規劃中的示範應用程式。它已列入藍圖,但尚未實作。