MCP-сервер для кодинг-агентов

функциональный

Позвольте Claude Code, Cursor, VS Code и Windsurf использовать ваши сохраненные подключения только для чтения через MCP, без передачи паролей.

SQLly может работать как локальный Сервер Model Context Protocol (MCP), поэтому агенты для работы с кодом, такие как Claude Code, Cursor, VS Code, Windsurf и Claude Desktop, могут использовать подключения, которые вы уже сохранили в SQLly. Агент может вывести список подключений, просмотреть таблицы, прочитать определения столбцов, получить сводку по схеме и выполнить один SELECT за раз, с ограничением числа строк. Он никогда не видит пароль, а подключения к production всегда отклоняются.

  • Локально и только через stdio. Агент запускается sqlly-cli mcp на вашей машине и общается с ней через стандартный ввод и вывод. Никто не прослушивает сетевой порт.
  • По умолчанию только для чтения. Запись возможна, только если вы решите её разрешить, и даже тогда каждая операция записи открывается в SQLly для вашего подтверждения.
  • Пароли остаются в вашей связке ключей. Сервер сам входит в ваши базы данных; агент получает только имена подключений, текст схемы и строки результатов.

Настройка

  1. Открыть Настройки › ИИ › 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, этот список не нужен.

Что может делать агент

ИнструментЧто оно делает
list_connectionsСписок доступных подключений с указанием их движка, сервера, базы данных, окружения и того, является ли каждое из них рабочим или только для чтения.
list_tablesСписок таблиц в базе данных подключения.
describe_tableСтолбцы, типы и допустимость NULL для одной таблицы.
get_schema_contextСводка схемы, подогнанная под лимит токенов.
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

Песочница Apple не даёт приложениям из App Store запускать другие программы, поэтому издание из Mac App Store не может работать как MCP-сервер для других приложений и не может запускать локальные (stdio) MCP-серверы. MCP-серверы, доступные по HTTP, там по-прежнему работают. См. macOS и Mac App Store.