供程式碼代理使用的 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 所連線的伺服器,讓 SQLly 自己的 AI 助理知道它們提供哪些工具。要讓代理使用 SQLly,並不需要這份清單。
代理程式可以做的事
| 工具 | 其作用 |
|---|---|
list_connections | 列出公開的連線,包括其引擎、伺服器、資料庫、環境,以及各自屬於正式環境還是唯讀。 |
list_tables | 列出連線資料庫中的資料表。 |
describe_table | 一張資料表的欄位、類型與 Null 屬性。 |
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唯讀畫面會生效,且 Redis 指令會對照唯讀清單檢查。
當允許寫入時, propose_write 本身不會執行任何東西。SQLly 會在新查詢分頁中開啟陳述式,在引擎支援時顯示預估列數與單行的計畫摘要,並且只會在你於平常的確認對話方塊中核准後才執行。
限制
- 資料列與儲存格。 每個查詢最多 100 列(既是預設值也是上限),長的儲存格值預設截斷為 200 字元(最多可到 2000)。
- 速率限制。 預設每分鐘 60 次查詢、5 次寫入、2 次結構描述變更,最多可調整至 600、60 和 20。
- 閒置逾時。 預設情況下,伺服器在 15 分鐘無請求後停止(可調整為 30 秒到一天)。
活動記錄
SQLly 會把 AI 代理發出的每一次工具呼叫,以及每個建議的處理結果,記錄在你機器上的私人日誌裡。每筆記錄都有時間、工具、連線、資料庫、耗時、列數和結果。SQL 以遮蔽過的形式儲存,絕不包含實際值。按下 開啟 MCP 活動 在 MCP 設定中瀏覽記錄,可依工具、結果或連線篩選,並匯出為 CSV 或 JSON。
Mac App Store 版本
蘋果的沙盒限制了 App Store 應用程式啟動其他程式,因此 Mac App Store 版本無法作為其他應用程式的 MCP 伺服器,也無法啟動本機(stdio)MCP 伺服器。透過 HTTP 存取的 MCP 伺服器仍然可以運作。請參見 macOS 與 Mac App Store.