跳至主要內容
翻譯頁面

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

Rust

在 Rust 應用程式中內嵌 StackQL MCP 伺服器,可以是下載的 sidecar,也可以使用 include_bytes! 透過 vendoring 納入您的二進位檔。用戶端是 rmcp。

資訊

內嵌的二進位檔會在首次執行時下載並經過 sha256 驗證,或透過 vendoring 納入您的應用程式。請參閱共同契約。


安裝​

加入 stackql-mcp crate:

stackql-mcp = "0.1"

快速入門​

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

API 為 StackqlMcp::builder(),搭配 .mode()、.auth()、.binary()、.bundle_path()、.approot()、.command()、.start() 與 .shutdown(),另有 .list_all_tools()。MSRV 為 Rust 1.88。


模式​

建立器預設為 Mode::ReadOnly。若要提升權限,請以 Mode::Safe、Mode::DeleteSafe 或 Mode::FullAccess 呼叫 .mode()。權限提升必須明確指定:除非您選擇加入,否則伺服器不會啟用變更或生命週期工具。


Vendoring / 內嵌​

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

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

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


示範應用程式​

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


github.com/stackql/stackql-mcp-rs