Mcp Sql Rust

io.github.rzlco666由 GitHub 帳號 rzlco666 發布v0.4.0更新於 Oct 24, 2026

Token-efficient MCP server for MySQL, PostgreSQL, and SQLite

發布方自己的服務:rust.wiki

已驗證STDIO僅桌面資料庫開發者工具

概覽

AI 產生的概覽

一個在本機執行、講求 token 效率的 MCP 伺服器,讓助理透過少量 SQL 工具檢視與查詢 MySQL、PostgreSQL 和 SQLite 資料庫。

可以做什麼
用 search_objects 搜尋資料表、結構描述等資料庫物件,用 execute_sql 執行 SQL,結果以欄位式回傳並限制列數與位元組數以節省 token。用 analyze_query_performance 分析查詢效能,包含逾時與資料庫引擎層級的語句限制。可透過 full-tools 參數啟用額外工具,DDL 別名僅在 allow-DDL 參數下可用。支援 stdio 或本機 HTTP 端點與健康檢查。
適用情境
適合在開發過程中讓助理探索或查詢關聯式資料庫,例如查看結構描述物件、執行唯讀 SQL 或排查查詢緩慢問題,而不必安裝重量級資料庫用戶端。
執行需求
以本機程序在使用者電腦上執行,透過對應平台的安裝包或安裝腳本安裝,僅支援桌面端。實際查詢需要 DATABASE_URL 連線字串;未設定時伺服器會以記憶體中的 SQLite 資料庫啟動。需要能連線到資料庫主機的網路。
安裝前請注意
DATABASE_URL 通常包含資料庫憑證,應視為機密。伺服器預設為唯讀,但 allow-writes 參數會啟用寫入層級,allow-DDL 參數會啟用結構描述變更,可能修改或刪除資料。安裝腳本是下載後直接管線交給 shell 執行,執行前應先檢視。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Sql Rust,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Strut Stack SQL

Light strut. Extreme load.

Token-efficient MCP server for MySQL, PostgreSQL, and SQLite — written in Rust. Part of the StrutStack ecosystem; usable standalone with any agent client.

[Latest release] [CI] [License: MIT]

Formerly published as mcp-sql-rust (compat binary alias still ships in v1.0).

Mission

  • Token thrift — default 3 tools, columnar {cols,rows,meta}, row/byte caps
  • Best-practice Rust — AST SQL guard before pool checkout, lean release binary
  • Multi-engine — PostgreSQL + MySQL + SQLite in one binary
  • Ship-ready — one-command install, stdio + Streamable HTTP, Cursor-friendly launcher

Install (one command)

bash
curl -fsSL https://raw.githubusercontent.com/rzlco666/strut-stack-sql/main/install.sh | bashstrut-stack-sql --version

Installs to ~/.local/bin (also creates mcp-sql-rust alias). Ensure ~/.local/bin is on your PATH.

Other channels (Homebrew, Scoop, winget, Docker, cargo): docs/INSTALL.md.

Quick start (Cursor)

json
{  "mcpServers": {    "strut-stack-sql": {      "command": "strut-stack-sql",      "args": ["--full-tools"],      "cwd": "${workspaceFolder}"    }  }}

Project .env:

env
DATABASE_URL=postgresql://user:[email protected]:5432/app

Without credentials the server still starts (ephemeral sqlite::memory:) so MCP initialize succeeds; set DATABASE_URL for real queries.

Official workspace launcher (loads nested apps/api/.env, never blocks start on dead DB):

json
{  "mcpServers": {    "strut-stack-sql": {      "command": "node",      "args": [        "/absolute/path/to/strut-stack-sql/packaging/cursor-mcp-launcher.mjs",        "${workspaceFolder}"      ]    }  }}

Why this shape

ChoiceDetail
Default toolssearch_objects, execute_sql, analyze_query_performance
Extra tools--full-tools (+ DDL aliases need --allow-ddl)
ResultsColumnar JSON only by default (token-efficient)
Guardsqlparser AST; multi-statement deny; write tiers; complexity limits
TimeoutsClient timeout + PG statement_timeout / MySQL max_execution_time
Transportsstdio · --http 127.0.0.1:8080 (/mcp, /healthz)

Measured RSS / cold-start vs Node rivals (same seed query): docs/BENCHMARKS.md. We do not invent QPS leaderboards.

CLI

bash
strut-stack-sql --versionstrut-stack-sql                          # stdio, read-onlystrut-stack-sql --allow-writesstrut-stack-sql --full-toolsstrut-stack-sql --http 127.0.0.1:8080

Docs

DocPurpose
docs/QUICKSTART.mdFirst run
docs/INSTALL.mdAll install channels
docs/SECURITY.mdGuard + write tiers
docs/TOOLS.mdTool schemas
docs/CONFIGURATION.md.env / TOML / CLI
docs/ARCHITECTURE.mdModules
docs/BENCHMARKS.mdReproducible harness

Agent clients

See AGENTS.md for Cursor / OMNI / CodeGraph conventions.

License

MIT

來源:README.md,提交 380a636

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.4.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Rust 整合