SchemaBrain — MCP-сервер для Claude Code: установка
SchemaBrain даёт агенту безопасный доступ к схеме Postgres без записи SQL и с аудитом вызовов. Нужен для управляемых запросов к данным.
claude mcp add schemabrain -e DATABASE_URL=<DATABASE_URL> -- uvx schemabrainЧто делает SchemaBrain
SchemaBrain подключает AI-агента к Postgres через слой определённых сущностей, связей и метрик. Сервер предоставляет двенадцать MCP-инструментов, но среди них нет записи в базу или произвольного выполнения SQL. Агент не получает прямой путь от промпта к изменению данных.
PII отслеживается от физической схемы через связи и метрики. Если запрос затрагивает запрещённую категорию, сервер отклоняет его до обращения к базе. Каждый вызов, отказ и восстановление попадают в добавляемый журнал с хешированием SHA256; команда audit verify обнаруживает переписанные строки. Поддерживается Postgres, а локальное хранилище использует SQLite. Для подключения нужна переменная DATABASE_URL, без неё сервер не запустится.
Какие задачи решает
- проверить, какие сущности доступны агенту
- рассчитать метрику по разрешённым связям
- отклонить запросы к PII до обращения к базе
- зафиксировать вызовы и отказы в аудите
- обнаружить переписанные записи журнала
Примеры запросов агенту
- Покажи сущности, которые SchemaBrain знает в подключённой базе.
- Рассчитай выручку по тарифам, используя только разрешённые связи.
- Проверь запрос к данным клиентов и отклони его, если он затрагивает PII.
Как установить SchemaBrain
Командой платформы
claude mcp add schemabrain -e DATABASE_URL=<DATABASE_URL> -- uvx schemabrainВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>
Командой платформы
codex mcp add schemabrain --env DATABASE_URL=<DATABASE_URL> -- uvx schemabrainВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>
Файл настроек
{
"mcpServers": {
"schemabrain": {
"command": "uvx",
"args": [
"schemabrain"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>
Файл настроек
{
"servers": {
"schemabrain": {
"type": "stdio",
"command": "uvx",
"args": [
"schemabrain"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> schemabrain uvx schemabrainВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о SchemaBrain
Как установить SchemaBrain в Claude Code?
Выполните claude mcp add schemabrain -e DATABASE_URL=<DATABASE_URL> -- uvx schemabrain. Переменная DATABASE_URL должна содержать адрес базы Postgres.
Что делает SchemaBrain?
Он даёт агенту доступ к управляемым сущностям, связям и метрикам Postgres. Запросы к PII отклоняются до обращения к базе, а вызовы попадают в журнал аудита.
Какие базы данных поддерживает SchemaBrain?
Сейчас сервер работает с Postgres. Его локальное хранилище использует SQLite.
