コーディングエージェント向け MCP サーバー

実装済み

Claude Code、Cursor、VS Code、Windsurf に、パスワードを共有することなく、保存済みの接続を MCP 経由で読み取り専用で使わせます。

SQLly はローカルの Model Context Protocol (MCP) サーバー、そのため、Claude Code、Cursor、VS Code、Windsurf、Claude Desktop などのコーディングエージェントが、SQLly に保存済みの接続を使えます。エージェントは、接続の一覧表示、テーブルの参照、列定義の読み取り、スキーマ概要の取得、1 つの SELECT 一度に、行数に上限を設けて。パスワードは一切見えず、本番接続は常に拒否されます。

  • ローカル専用で stdio のみ。 エージェントが起動します sqlly-cli mcp マシン上で動作し、標準入出力を介してやり取りします。ネットワークポートで待ち受けるものはありません。
  • 既定では読み取り専用です。 書き込みは、許可することを選んだ場合にのみ行えます。その場合でも、個々の書き込みは SQLly で開いて確認することになります。
  • パスワードはキーチェーンに保存されます。 サーバー自身がデータベースにサインインします。エージェントが受け取るのは、接続名、スキーマのテキスト、結果の行だけです。

設定方法

  1. 開く 設定 › AI › MCP と検索 MCP サーバーとしての SQLLY.
  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_table1 つのテーブルの列、型、NULL 許容。
get_schema_contextトークン予算に収まるように調整されたスキーマの要約。
run_readonly_query1件の SELECT 最大で行数の上限まで返します。それ以外は実行せずに拒否されます。
open_in_appSQLly でクエリタブを開きます。必要に応じて SQL を入力した状態で開けます。何も実行されません。
propose_writeSQLly で確認できるよう、データを変更するステートメントを提案します(書き込みが許可されている場合のみ)。
get_proposal_status提案が保留中、オープン済み、実行済み、却下、期限切れのいずれであるかを示します。

読み取り専用モードと読み書きモード

その グローバル上限 は、1 つの接続に許される最大値を設定します。各接続でそれより低く設定できます: グローバル設定を継承, ロック済み (まったく公開されない)、 読み取り専用、または 確認付きの読み書き。接続数がグローバルな上限を超えることはありません。

読み取り専用は、SQLly のステートメントチェックだけでなく、データベース側でも強制されます。PostgreSQL、MySQL、MariaDB では、各クエリは常にロールバックされる読み取り専用トランザクション内で実行されます。SQLite ではクエリ専用(query-only)として実行されます。読み取り専用トランザクションを持たない SQL Server では、ロールバックされるトランザクション内で実行したうえで、ステートメントのスクリーニングも行われます。ClickHouse では SELECT-only の画面チェックが適用され、Redis コマンドは読み取り専用リストと照合されます。

書き込みを許可すると、 propose_write それ自体は何も実行しません。SQLly はステートメントを新しいクエリタブで開き、エンジンが対応している場合は推定行数と 1 行のプラン概要を表示し、承認したあとに通常の確認ダイアログを経由してのみ実行します。

本番は立ち入り禁止です。 接続は、環境が Production の場合、またはユーザーが本番としてマークした場合に、本番接続として扱われます。エージェントは一覧でそれを確認できますが、他のすべてのツールは、読み取りを含めて、その接続へのアクセスを拒否します。

制限

  • 行とセル。 クエリごとに最大 100 行 (既定値かつ上限)。長いセル値は既定で 200 文字で切り捨てられます (最大 2000 文字まで)。
  • レート制限。 既定では 1 分あたり、クエリ 60 件、書き込み 5 件、スキーマ変更 2 件で、最大 600、60、20 まで調整できます。
  • アイドルタイムアウト。 サーバーは、既定ではリクエストがないまま 15 分経つと停止します(30 秒から 1 日まで調整可能)。

アクティビティログ

SQLly は、エージェントが行うすべてのツール呼び出しと、すべての提案の結果を、お使いのマシン上の非公開ログに記録します。各エントリには、時刻、ツール、接続、データベース、所要時間、行数、結果が含まれます。SQL は、リテラルの値を伏せた形で保存され、生の値がそのまま保存されることはありません。押すと MCP アクティビティを開く MCP の設定で、ツール、結果、接続でフィルタリングし、CSV や JSON としてエクスポートします。

Mac App Store版

Apple のサンドボックスにより、App Store アプリは他のプログラムを起動できません。そのため、Mac App Store 版は他のアプリ向けの MCP サーバーとして動作できず、ローカル (stdio) の MCP サーバーを起動することもできません。HTTP 経由で接続する MCP サーバーは、引き続き利用できます。参照 macOS と Mac App Store.