Byaan MCP
MCP-сервер Byaan передает Claude Code и Cursor вопросы к вашим базам данных и возвращает запросы с результатами в режиме чтения.
- 96 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Данные из ваших баз доходят до внешней модели, если выбран облачный поставщик.
- Версия Community не содержит авторизации, а защита от записи действует на уровне приложения.
Установка
- Работает в
Ручная установка
git clone https://github.com/byaan-ai/byaan.git && cd byaan && docker compose up -dВерсия Community запускается в Docker и открывается на `http://localhost:17434`. Есть также приложение для Mac и командная версия.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Данные из ваших баз доходят до внешней модели, если выбран облачный поставщик.
- Версия Community не содержит авторизации, а защита от записи действует на уровне приложения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Byaan — ИИ-аналитик с открытым кодом: он находит схему баз, запоминает определения метрик и бизнес-правила, строит запросы, графики и дашборды. Его MCP-сервер дает те же возможности агенту прямо в редакторе или терминале. Подключаются PostgreSQL, MySQL, MongoDB, SQLite, MSSQL, ODBC и файлы CSV, Excel, Parquet, JSON. Модель выбирает сам пользователь: Claude, OpenAI, Azure OpenAI, AWS Bedrock, Groq, OpenRouter или xAI. Защита от записи проверяет запросы и блокирует известные операции изменения данных. В репозитории лежат скиллы `/byaan:start`, `/byaan:learn` и `/byaan:mcp-setup`. Первый разворачивает сервис и подключает MCP, второй заново разбирает схему после изменений.
Для кого. Аналитикам и разработчикам, которым нужны ответы из баз данных без ручных SQL-запросов, и командам, готовым развернуть сервис у себя.
Подходит, если
- Менеджер спрашивает агента, сколько заказов вернули за квартал, и надо показать запрос, а не только цифру
- Схема базы изменилась, и агент должен заново изучить таблицы командой `/byaan:learn`
- В терминале открыт Claude Code, а данные лежат в Parquet или Excel на диске
- Определение «выручки» в компании сложное, и его хочется зафиксировать один раз для всех будущих вопросов
Не подходит, если
- Требуется запись в базу: защита блокирует изменения данных
- Общий сервер без ограничения доступа: версия Community не содержит встроенной авторизации
- Данные нельзя отправлять внешнему поставщику модели, а локальной модели нет
Пример запроса к агенту
Покажи таблицы в моей базе, а затем найди десять клиентов с самой большой суммой заказов за год и приведи запрос.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Фрагменты схемы и результаты запросов уходят выбранному поставщику модели. Версия Community не содержит авторизации: запускайте ее локально или в закрытой сети. Защита от записи работает на уровне приложения, поэтому для боевых баз заведите пользователя только с правом чтения. Папка `server/ee/` распространяется по лицензии Elastic License 2.0, остальной код по MIT. Облачная версия просит ключ MCP.
Как отключить. Удалите запись `byaan` из настроек MCP (`claude mcp remove byaan`) и остановите контейнер командой `docker compose down`. Сохраненные знания о схеме лежат в локальной базе приложения.
Частые вопросы
Как подключить Byaan к Claude Code?
Выполните `claude mcp add-json byaan` с конфигурацией из README: для приложения Mac в ней путь к встроенному бинарному файлу, для локальной сборки команда `uv run python -m server.mcp.stdio_server`. Проверка: попросите агента перечислить таблицы.
Может ли Byaan изменить данные в базе?
Нет, он рассчитан на чтение: запросы проверяются слоями защиты для SQL, MongoDB, DynamoDB и DuckDB. Это дополнительная мера, поэтому для боевых баз все равно нужен пользователь с правом только чтения.
Какие базы и файлы поддерживаются?
PostgreSQL, MongoDB, MySQL, SQLite, MSSQL, ODBC, а также файлы CSV, Excel, Parquet и JSON. Файлы обрабатывает DuckDB на вашей машине.
Нужен ли аккаунт для Byaan?
Для приложения Mac и версии Community аккаунт не нужен: модель настраивается в самом приложении. Облачная версия просит ключ MCP из профиля.
Что уходит из моей сети?
Подключения к базам остаются у вас, а схема и результаты запросов могут уходить выбранному поставщику модели. Трафик баз не идет через серверы Byaan.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыВстроенный MCP-сервер мультимодельной СУБД ArcadeDB: агент читает граф, документы и векторы, а запись включается по операциям.
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
SQL-движок на SQLite с плагинами для приложений, баз и файлов: команда anyquery mcp открывает эти данные Claude, Cursor и другим клиентам MCP
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
MCP-сервер на Go: агент задает вопросы базе PostgreSQL обычными словами и получает результат запроса
Keboola MCP Server открывает ассистентам платформу Keboola: таблицы, SQL, запуск заданий, потоки и приложения с данными.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Byaan (эта карточка) | да | не нужна | 96 | |
| DBHub | нет | не нужна | 3 839 | универсальный MCP-доступ к базам; Byaan хранит определения метрик и строит дашборды |
| Postgres MCP Pro | нет | API-ключ | 3 469 | сфокусирован на PostgreSQL; Byaan подключает разные базы и файлы |
Коротко о README
Byaan работает как приложение для Mac, контейнер Docker или командная версия с авторизацией. Во всех вариантах агент подключается через MCP, а схема и определения метрик накапливаются между сессиями.