masume MCP
Терминальный клиент баз данных с ИИ-чатом и режимом masume --mcp: агент работает с базами в заданных границах доступа.
- 108 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Уровни `read-write` и `full` разрешают записи, а `full` еще `DROP` и `TRUNCATE` в подключенной базе.
- Результаты запросов, в том числе персональные данные из таблиц, попадают в контекст модели.
- Пароли профилей берутся из окружения или связки ключей и доступны процессу сервера.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/masumeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Уровни `read-write` и `full` разрешают записи, а `full` еще `DROP` и `TRUNCATE` в подключенной базе.
- Результаты запросов, в том числе персональные данные из таблиц, попадают в контекст модели.
- Пароли профилей берутся из окружения или связки ключей и доступны процессу сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`masume` — клиент баз данных для терминала с управлением с клавиатуры: PostgreSQL, MySQL, MariaDB, SQL Server, ClickHouse, SQLite, Cassandra, ScyllaDB, Redis, MongoDB и облачные Neon, Supabase, PlanetScale, Turso. Есть ИИ-чат и записные книжки с запросами. Команда `masume --mcp` запускает MCP-сервер по stdio: внешний агент получает `list_profiles`, `list_tables`, `describe_table`, `explain_query`, `plan_write`, `run_query` и чтение записных книжек. Доступны только профили из `[mcp] profiles` глобального конфига, а уровень `access` по умолчанию `read-only`. Уровни `read-write` и `full` разрешают записи, а `full` еще `DELETE`, `DROP` и `TRUNCATE`.
Для кого. Разработчикам и аналитикам, которые работают с базами в терминале и подключают к ним агента с ограниченными правами.
Подходит, если
- Агент строит запрос по схеме базы и объясняет результат, не имея права писать.
- Перед массовым `UPDATE` агент показывает число строк и триггеры через `plan_write`.
- В проекте есть `.masume.toml` с профилями, а в MCP открыт только один: `--profile=shop`.
- Нужно найти базы в запущенных контейнерах: `masume --detect`.
Не подходит, если
- Нужна графическая среда с диаграммами и визуальными редакторами.
- Профиль указывает на боевую базу, а уровень `full` не продуман.
- Пароль вводится только в терминале: MCP-сервер не может его запросить.
Пример запроса к агенту
Покажи таблицы базы shop, опиши таблицу orders и построй запрос с числом заказов по дням за последнюю неделю.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
MCP-сервер читает только профили, перечисленные в `[mcp] profiles` глобального конфига: при пустом списке не доступно ничего, и проектный `.masume.toml` добавить профиль в список не может. Пароль берется из переменной окружения, связки ключей, команды или хранилища секретов, поэтому профиль с вводом пароля в терминале для MCP недоступен. `masume` не обновляет себя сам. Для установки через `go install` нужен Go 1.27 или новее, пакеты Alpine README помечает как неподписанные.
Как отключить. Уберите запись сервера из конфигурации клиента (`claude mcp remove masume`) или оставьте `[mcp] profiles` пустым. Ключи в связке ключей и профили удалите отдельно.
Частые вопросы
Что видит агент по умолчанию?
Только профили из `[mcp] profiles` и только чтение: `access` по умолчанию `read-only`. Пустой список профилей не открывает ничего.
Как ограничить сервер одной базой?
Запустите `masume --mcp --profile=shop`. Профиль должен быть в списке разрешенных, а у инструментов исчезает аргумент `profile`.
Как проверить подключение?
Выполните `masume --mcp --check`: в stderr для каждого профиля выводится `ok` с числом таблиц или `FAILED` с ошибкой.
Работает ли MCP при выключенном ИИ-чате?
Да. MCP не зависит от `[ai] enabled` и не использует учетные данные ИИ-чата.
Как подключить к Claude Code?
Командой `claude mcp add --scope user masume -- masume --mcp`. Для других клиентов в документации есть примеры конфигурации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОдин MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
MCP-сервер для доступа агента к MySQL: чтение схемы и запросы, по умолчанию только на чтение, запись включается флагами
MCP-сервер на Go: агент задает вопросы базе PostgreSQL обычными словами и получает результат запроса
vi-sql — терминальный клиент для SQL-баз со встроенным MCP-сервером: агент видит схему и пишет запросы прямо в ваш редактор
MCP-сервер на Python для работы с MySQL: список таблиц, чтение данных, выполнение SQL и разбор схемы через контролируемый интерфейс
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| masume (эта карточка) | нет | не нужна | 108 | |
| DBHub | нет | не нужна | 3 839 | универсальный MCP для баз данных; masume сначала клиент для терминала, а MCP ограничен профилями и уровнями доступа |
| MCP Toolbox for Databases | да | не нужна | 16 857 | сервер от Google с настраиваемыми инструментами; здесь готовые инструменты и терминальный клиент |
Коротко о README
Сервер объявляет JSON-RPC 2.0 по одной строке на сообщение. Параметр `confirm_writes` задает подтверждение для удалений, записей или всех деструктивных операций.