# SchemaBrain

SchemaBrain даёт агенту безопасный доступ к схеме Postgres без записи SQL и с аудитом вызовов. Нужен для управляемых запросов к данным.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: Arun-kc
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Arun-kc/schemabrain
- Обновлён: 2026-08-24
- HTML: https://affpapa.org/nevibecode/mcp/schemabrain

## Что делает

SchemaBrain подключает AI-агента к Postgres через слой определённых сущностей, связей и метрик. Сервер предоставляет двенадцать MCP-инструментов, но среди них нет записи в базу или произвольного выполнения SQL. Агент не получает прямой путь от промпта к изменению данных.

PII отслеживается от физической схемы через связи и метрики. Если запрос затрагивает запрещённую категорию, сервер отклоняет его до обращения к базе. Каждый вызов, отказ и восстановление попадают в добавляемый журнал с хешированием SHA256; команда `audit verify` обнаруживает переписанные строки. Поддерживается Postgres, а локальное хранилище использует SQLite. Для подключения нужна переменная `DATABASE_URL`, без неё сервер не запустится.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `DATABASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add schemabrain -e DATABASE_URL=<DATABASE_URL> -- uvx schemabrain
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>

### Codex

**Командой платформы**
```bash
codex mcp add schemabrain --env DATABASE_URL=<DATABASE_URL> -- uvx schemabrain
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "schemabrain": {
            "command": "uvx",
            "args": [
                "schemabrain"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "schemabrain": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "schemabrain"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e DATABASE_URL=<DATABASE_URL> schemabrain uvx schemabrain
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from schemabrain <команда>

## Когда брать
- проверить, какие сущности доступны агенту
- рассчитать метрику по разрешённым связям
- отклонить запросы к PII до обращения к базе
- зафиксировать вызовы и отказы в аудите
- обнаружить переписанные записи журнала

## Примеры запросов агенту
- Покажи сущности, которые SchemaBrain знает в подключённой базе.
- Рассчитай выручку по тарифам, используя только разрешённые связи.
- Проверь запрос к данным клиентов и отклони его, если он затрагивает PII.

## Похожие
- [januscope](https://affpapa.org/nevibecode/mcp/januscope.md) — MCP-сервер · ★ 32
- [MCP Gateway](https://affpapa.org/nevibecode/mcp/panossalt-mcp-gateway.md) — MCP-сервер · ★ 6
- [platform-datamask-run](https://affpapa.org/nevibecode/skills/platform-datamask-run.md) — скилл · 1400 установок
- [gemini-history-analyzer](https://affpapa.org/nevibecode/skills/gemini-history-analyzer.md) — скилл · 321 установка
- [Covenant Guard](https://affpapa.org/nevibecode/mcp/covenant-guard.md) — MCP-сервер · ★ 8
- [Arcaeon](https://affpapa.org/nevibecode/mcp/arcaeon.md) — MCP-сервер · ★ 1

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md