面向编码代理的 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 里打开,等你确认。
  • 密码保存在你的钥匙串中。 服务器会自行登录你的数据库;代理只会收到连接名称、架构文本和结果行。

进行设置

  1. 打开 设置 › AI › MCP 并找到 将 SQLLY 作为 MCP 服务器.
  2. 选择 全局上限: 只读(默认),或 读写需确认。选择要公开哪些已保存的连接。
  3. 点击适用于你的智能体的复制按钮: 为 Claude Code 复制, 为 Cursor 复制, 为 VS Code 复制, 为 Windsurf 复制 或者 为 Claude Desktop 复制,并将代码片段粘贴到该代理保存其 MCP 服务器的位置。
  4. 让代理列出你的 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 会在新的查询标签页中打开这条语句,在引擎支持时显示估计行数和一行式的计划摘要,并且只在你通过常规确认对话框批准后才会运行。

生产环境是禁区。 连接的环境为 Production,或者你手动把它标记为生产环境时,该连接就是生产连接。代理可以在列表中看到它,但其他所有工具都会拒绝访问,连读取也不例外。

限制

  • 行和单元格。 每个查询最多 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.