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 集成