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 для вашего подтверждения.
- Пароли остаются в вашей связке ключей. Сервер сам входит в ваши базы данных; агент получает только имена подключений, текст схемы и строки результатов.
Настройка
- Открыть Настройки › ИИ › 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, этот список не нужен.
Что может делать агент
| Инструмент | Что оно делает |
|---|---|
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 открывает оператор в новой вкладке запроса, показывает предполагаемое число строк и однострочную сводку плана там, где движок это поддерживает, и выполняет его только через обычный диалог подтверждения после вашего одобрения.
Ограничения
- Строки и ячейки. Не более 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.