mcp-server-mysql

mcp-server-mysql — MCP-сервер сообщества (автор — benborla). Работа с MySQL с настраиваемым доступом и просмотром схемы. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
benborla
Лицензия
MIT
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
javascript

Уровень риска: high

Доступ к базе MySQL; запись выключена по умолчанию и включается флагами ALLOW_*_OPERATION.

Настройка клиентов

claude-code
{
    "code": "claude mcp add mcp_server_mysql \\\n  -e MYSQL_HOST=\"127.0.0.1\" \\\n  -e MYSQL_PORT=\"3306\" \\\n  -e MYSQL_USER=\"root\" \\\n  -e MYSQL_PASS=\"your_password\" \\\n  -e MYSQL_DB=\"your_database\" \\\n  -- npx @benborla29/mcp-server-mysql",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MCP Server for MySQL даёт Claude и другим LLM доступ к MySQL через Model Context Protocol. Агент изучает схемы, выполняет запросы и при желании записывает данные. По умолчанию сервер работает только на чтение — запись включается отдельными флагами.

Возможности:

  • Инструмент mysql_query — выполняет SQL-запросы. По умолчанию только чтение, запись включается флагами по типам операций.
  • Ресурс mysql://tables — список всех таблиц и метаданные столбцов подключённой базы.
  • Работа с несколькими базами (Multi-DB) — запросы к разным базам без переподключения.
  • Права по схемам — чтение и запись настраиваются отдельно для каждой базы.
  • Маскирование персональных данных — чувствительные данные в результатах скрываются автоматически.
  • SSH-туннель — встроенная поддержка удалённых баз.
  • Удалённый режим — HTTP-транспорт с аутентификацией по bearer-токену.
  • SSL/TLS — шифрованное соединение, есть вариант с mTLS.

Авторы отмечают, что сервер оптимизирован для Claude Code CLI.

Кому подойдёт

  • Разработчикам на MySQL: агент сам смотрит структуру таблиц и пишет запросы под реальную схему.
  • Аналитикам: выборки и отчёты по базе обычным текстом, в безопасном режиме только для чтения.
  • Командам с удалённой базой: подключение через SSH-туннель или по TLS.

Похожие серверы — в категории базы данных.

Установка

Нужны Node.js 20+, MySQL 5.7+ (рекомендуется 8.0+) и пользователь MySQL с подходящими правами. Сервер запускается через npx @benborla29/mcp-server-mysql. Параметры подключения передаются переменными окружения: MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB.

Запись по умолчанию выключена. Её включают флаги ALLOW_INSERT_OPERATION=true, ALLOW_UPDATE_OPERATION=true и ALLOW_DELETE_OPERATION=true. Установка через Smithery, в Cursor и Codex, из локального репозитория и в удалённом режиме описана в docs/INSTALLATION.md репозитория.

Подключение к клиентам

Команда и конфиг приведены дословно из README. Вместо заглушек подставьте свои данные подключения и не публикуйте пароль. Общий порядок — в инструкции как подключить MCP.

claude mcp add mcp_server_mysql \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="your_password" \
  -e MYSQL_DB="your_database" \
  -- npx @benborla29/mcp-server-mysql

Этот же JSON подходит и для других клиентов с форматом mcpServers.

Проверка

Попросите агента показать список таблиц базы — он прочитает ресурс mysql://tables. Затем попросите простую выборку через mysql_query.

Примеры задач

Покажи структуру таблицы orders и посчитай заказы по месяцам за этот год.
Найди пользователей без заказов за последние 90 дней.

Риски

Сервер получает доступ к вашей базе MySQL. Если включить флаги записи, агент сможет добавлять, изменять и удалять данные. Не включайте их без необходимости и не используйте для агента пользователя root. Заведите отдельного пользователя MySQL с минимальными правами и при необходимости настройте права по схемам.

Пароль базы — секрет: храните его в переменных окружения и не коммитьте конфиг с ним. Для персональных данных включите маскирование, для удалённых баз — TLS или SSH-туннель. В удалённом режиме сервер защищён bearer-токеном — храните его так же бережно. Лицензия — MIT.

Частые вопросы

Может ли агент случайно удалить данные?

По умолчанию нет: все операции записи выключены. Удаление станет возможным, только если задать ALLOW_DELETE_OPERATION=true.

Можно ли работать с несколькими базами сразу?

Да, в режиме Multi-DB — он описан в README-MULTI-DB.md репозитория.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники