供程式碼代理使用的 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 所連線的伺服器,讓 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 會在新查詢分頁中開啟陳述式,在引擎支援時顯示預估列數與單行的計畫摘要,並且只會在你於平常的確認對話方塊中核准後才執行。

正式環境禁止進入。 連線的環境設為 Production,或你親手標記時,它就是正式環境連線。代理程式能在清單中看到它,但其他所有工具都會拒絕它——連讀取也一樣。

限制

  • 資料列與儲存格。 每個查詢最多 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.