面向编码代理的 MCP 服务器
功能的让 Claude Code、Cursor、VS Code 和 Windsurf 通过 MCP 以只读方式使用你保存的连接,且不共享任何密码。
SQLly 可以作为本地 模型上下文协议 (MCP) 服务器,因此 Claude Code、Cursor、VS Code、Windsurf、Claude Desktop 这类编码代理就能使用你已在 SQLly 中保存的连接。代理可以列出连接、浏览表、读取列定义、获取模式摘要,并运行一个
SELECT ,而且行数设有上限。它绝不会接触密码,生产连接则一律被拒绝。
- 仅限本地和 stdio。 代理启动
sqlly-cli mcp在你的机器上运行,通过标准输入输出与它通信。不监听任何网络端口。 - 默认只读。 只有你选择允许时才会执行写入;即便如此,每次写入也都会在 SQLly 里打开,等你确认。
- 密码保存在你的钥匙串中。 服务器会自行登录你的数据库;代理只会收到连接名称、架构文本和结果行。
进行设置
- 打开 设置 › AI › MCP 并找到 将 SQLLY 作为 MCP 服务器.
- 选择 全局上限: 只读(默认),或 读写需确认。选择要公开哪些已保存的连接。
- 点击适用于你的智能体的复制按钮: 为 Claude Code 复制, 为 Cursor 复制, 为 VS Code 复制, 为 Windsurf 复制 或者 为 Claude Desktop 复制,并将代码片段粘贴到该代理保存其 MCP 服务器的位置。
- 让代理列出你的 SQLly 连接。
代码片段会显示完整路径到 sqlly-cli,即随应用一同打包的命令行工具。SQLly 会先在应用旁边查找它,然后到你的
PATH;如果两者都找不到,代码片段就只显示 sqlly-cli。形状如下:
# Claude Code claude mcp add --transport stdio sqlly -- /path/to/sqlly-cli mcp // Cursor, Windsurf and Claude Desktop { "mcpServers": { "sqlly": { "command": "/path/to/sqlly-cli", "args": ["mcp"] } } } // VS Code (.vscode/mcp.json) { "servers": { "sqlly": { "type": "stdio", "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }
同一个窗格中还会列出 外部的 MCP 服务器。这个列表是另一个方向:SQLly 主动连接的服务器,让自己的 AI 助手知道对方提供哪些工具。要让代理使用 SQLly,并不需要它。
智能体可以做什么
| 工具 | 作用 |
|---|---|
list_connections | 列出暴露的连接及其引擎、服务器、数据库和环境,以及每个连接是生产环境还是只读。 |
list_tables | 列出连接的数据库中的表。 |
describe_table | 单个表的列、类型和可空性。 |
get_schema_context | 按 token 预算控制大小的模式摘要。 |
run_readonly_query | 只运行一条 SELECT 并最多返回到行数上限为止。其他任何语句都会被拒绝,不会运行。 |
open_in_app | 在 SQLly 中打开一个查询标签页,可选择预先填入 SQL。不会执行任何操作。 |
propose_write | 提出一条会更改数据的语句,由你在 SQLly 中确认(仅在允许写入时)。 |
get_proposal_status | 提案处于待处理、已打开、已执行、已拒绝还是已过期状态。 |
只读和读写模式
这 全局上限 设置的是所有连接允许的上限。之后每个连接都可以设得更低: 继承全局设置, 已锁定 (完全未对外暴露), 只读,或 读写需确认。单个连接永远不会得到比全局上限更高的限额。
只读由数据库强制执行,而不仅仅是 SQLly 的语句检查。在 PostgreSQL、MySQL 和 MariaDB 上,每个查询都在一个始终会回滚的只读事务中运行;SQLite 以仅查询模式运行;SQL Server 没有只读事务,因此在一个会回滚的事务内运行,并额外进行语句筛查。在 ClickHouse 上,只有 SELECT-only 的语句筛查会生效,Redis 命令则会对照一份只读命令清单进行检查。
允许写入时, propose_write 它自己从不运行任何东西。SQLly 会在新的查询标签页中打开这条语句,在引擎支持时显示估计行数和一行式的计划摘要,并且只在你通过常规确认对话框批准后才会运行。
限制
- 行和单元格。 每个查询最多 100 行(默认值和上限),并且长单元格值默认在 200 个字符处截断(最多可达 2000 个字符)。
- 速率限制。 默认每分钟 60 次查询、5 次写入和 2 次模式变更,最多可调到 600、60 和 20。
- 空闲超时。 默认情况下,服务器在 15 分钟没有请求后会停止(可在 30 秒到一天之间调节)。
活动日志
SQLly 会把代理执行的每一次工具调用以及每个提案的结果,记录在你自己机器上的一个私有日志里。每条记录包含时间、工具、连接、数据库、耗时、行数和结果。SQL 以脱敏形式存储,绝不带字面值。按 打开 MCP 活动 ,可在 MCP 设置中浏览它,按工具、结果或连接筛选,并导出为 CSV 或 JSON。
Mac App Store 版本
苹果的沙盒会阻止 App Store 应用启动其他程序,因此 Mac App Store 版无法作为其他应用的 MCP 服务器,也无法启动本地(stdio)MCP 服务器。通过 HTTP 访问的 MCP 服务器在那里仍然可用。参见 macOS 与 Mac App Store.