翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何在 Rust 應用程式中內嵌 StackQL MCP 伺服器
StackQL 的 MCP 伺服器可以在 Rust 二進位檔內執行,不需要 npx、無需另外安裝,也沒有執行階段相依性。stackql-mcp crate 會在 rmcp 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔,讓您的 Rust 應用程式取得受治理、可自我描述的 SQL 介面,存取 StackQL 登錄庫中的每個雲端與 SaaS Provider。這正是 auditron 背後的模式,它是以單一二進位檔發行的終端機合規性助手。
步驟
- 新增 crate 至
Cargo.toml:
stackql-mcp = "0.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。
- 選擇模式。
.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 單一二進位檔發行。
相關概念
- 內嵌式 MCP:Rust 參考:安裝、API 與功能旗標
- 如何搭配 AI 代理程式使用 StackQL:MCP 模型與安全模式
- StackQL MCP 架構:傳輸方式、模式與稽核內部機制
- 什麼是代理式基礎架構?:此做法促成的模式