跳至主要內容
翻譯頁面

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

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

StackQL 的 MCP 伺服器可以在 Rust 二進位檔內執行,不需要 npx、無需另外安裝,也沒有執行階段相依性。stackql-mcp crate 會在 rmcp 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,讓您的 Rust 應用程式取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。這正是 auditron 背後的模式,它是以單一二進位檔發行的終端機合規性助手。

步驟​

  1. 新增 crate 至 Cargo.toml:
stackql-mcp = "0.1"
  1. 建立伺服器並列出工具。建立器預設為 Mode::ReadOnly:
use stackql_mcp::{Mode, StackqlMcp};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let server = StackqlMcp::builder()
.mode(Mode::ReadOnly)
.auth(serde_json::json!({"github": {"type": "null_auth"}}))
.start()
.await?;
let tools = server.list_all_tools().await?;
println!("{} tools available", tools.len());
server.shutdown().await?;
Ok(())
}

建立器還提供 .binary()、.bundle_path()、.approot() 與 .command()。MSRV 為 Rust 1.88。

  1. 選擇模式。.mode() 預設為 Mode::ReadOnly。只有在應用程式需要佈建時,才設定 Mode::Safe、Mode::DeleteSafe 或 Mode::FullAccess。權限提升需明確指定。

使用 include_bytes! 發行單一二進位檔​

兩個功能旗標控制二進位檔的取得方式:

  • sidecar(預設):在首次執行時下載、驗證並快取已簽署的二進位檔。
  • vendored:以 include_bytes! 內嵌二進位檔,產生單一獨立式可執行檔。

vendored 二進位檔會使建置增加約 80 MB。

示範應用程式​

auditron 是一個終端機合規性助手:這個 TUI 會以串流方式顯示通過/失敗結果,並附上所執行的 SQL 與 Claude 的說明,以約 80 MB 的 vendored 單一二進位檔發行。