safedb-mcp — MCP-сервер для Claude Code: запросы к БД
MCP-сервер даёт ИИ-агенту ограниченный доступ к базам данных только для чтения. Подходит для безопасного просмотра схем и выполнения SQL-запросов.
claude mcp add safedb-mcp -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcpЧто делает safedb-mcp
safedb-mcp подключает Claude Code и другие поддерживаемые клиенты к Postgres, MySQL, MariaDB или SQLite. Агент получает инструменты для просмотра схем, таблиц и описаний, запуска запросов только для чтения, проверки плана и просмотра политики доступа.
Перед выполнением SQL сервер разбирает запрос и проверяет таблицы, соединения, CTE, вложенные подзапросы, псевдонимы и объединения. В конфигурации задаются разрешённые и запрещённые таблицы, лимиты строк, тайм-аут и маскирование PII. Попытки запросов записываются в JSONL-аудит без строк результата.
Для production нужен отдельный пользователь базы с правами только на чтение: сам сервер служит дополнительным уровнем защиты, а не заменяет минимальные привилегии. Запросы на запись, миграции, процедуры и COPY заблокированы.
Какие задачи решает
- просматривать схемы и таблицы базы через агента
- выполнять разрешённые SQL-запросы только для чтения
- скрывать PII-поля перед возвратом результата
- вести аудит попыток доступа без сырых строк
Примеры запросов агенту
- Покажи доступные схемы и таблицы в подключённой базе.
- Опиши таблицу
usersи выполни безопасный запрос по заказам. - Проверь план этого запроса и объясни, какие таблицы он затрагивает.
Как установить safedb-mcp
Командой платформы
claude mcp add safedb-mcp -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add safedb-mcp --env YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"safedb-mcp": {
"command": "npx",
"args": [
"-y",
"@safedb/safedb-mcp"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"safedb-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@safedb/safedb-mcp"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YOUR_API_KEY=<YOUR_API_KEY> safedb-mcp npx -y @safedb/safedb-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о safedb-mcp
Как установить safedb-mcp в Claude Code?
Выполните claude mcp add safedb-mcp -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcp.
Что делает safedb-mcp?
Сервер позволяет агенту исследовать схемы и выполнять SQL только для чтения в Postgres, MySQL, MariaDB и SQLite. Доступ ограничивается конфигурацией, результаты могут маскироваться, а попытки записываются в аудит.
Какие операции safedb-mcp блокирует?
Сервер блокирует операции записи, миграции, запуск хранимых процедур и COPY. SQL проверяется до выполнения, а результат ограничивается лимитом строк.
