Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

Rust

Вбудуйте сервер MCP StackQL у застосунок Rust: або як завантажений sidecar, або включивши його у ваш двійковий файл через вендоринг за допомогою include_bytes!. Клієнт - rmcp.

інформація

Вбудований двійковий файл завантажується й перевіряється за sha256 під час першого запуску або включається у ваш застосунок через вендоринг. Див. Спільний контракт.


Встановлення​

Додайте crate stackql-mcp:

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() зі значенням Mode::Safe, Mode::DeleteSafe або Mode::FullAccess. Підвищення рівня доступу завжди явне - сервер не вмикає інструменти змінення даних і життєвого циклу, якщо ви явно їх не ввімкнете.


Вендоринг / вбудовування​

Джерело двійкового файлу визначають дві можливості Cargo (features):

  • sidecar (за замовчуванням) - завантаження, перевірка й кешування підписаного двійкового файлу під час першого запуску.
  • vendored - вбудовування двійкового файлу за допомогою include_bytes!, щоб отримати один автономний виконуваний файл.

Двійковий файл, включений через вендоринг, збільшує збірку приблизно на 80 MB.


Демонстраційний застосунок​

auditron - термінальний помічник для перевірки відповідності вимогам: TUI, що в потоковому режимі виводить результати перевірок (пройдено/не пройдено) разом із відповідним SQL і поясненнями від Claude. Він постачається як один двійковий файл обсягом ~80 MB, включений через вендоринг.


github.com/stackql/stackql-mcp-rs