mysql_mcp_server

mysql_mcp_server — MCP-сервер сообщества (автор — designcomputer). Работа с MySQL с контролем доступа и просмотром схемы. Ставится через pip. Лицензия MIT.

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

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

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

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

execute_sql разрешает INSERT/UPDATE/DELETE; используйте отдельного пользователя MySQL с минимальными правами.

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

vscode
{
    "code": "{\n  \"mcpServers\": {\n    \"mysql\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"mysql-mcp-server\",\n        \"mysql_mcp_server\"\n      ],\n      \"env\": {\n        \"MYSQL_HOST\": \"localhost\",\n        \"MYSQL_PORT\": \"3306\",\n        \"MYSQL_USER\": \"your_username\",\n        \"MYSQL_PASSWORD\": \"your_password\",\n        \"MYSQL_DATABASE\": \"your_database\"\n      }\n    }\n  }\n}",
    "file": "mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

MySQL MCP Server — реализация Model Context Protocol для безопасной работы с базами MySQL. Сервер связывает ИИ-приложения с MySQL и делает изучение и анализ базы безопаснее и структурированнее. Поддерживаются транспорт STDIO и Streamable HTTP (SSE). SSE авторы рекомендуют для удалённых и собственных развёртываний.

Инструменты:

  • execute_sql — выполняет стандартные SQL-запросы: SELECT, SHOW, DESCRIBE и изменение данных (INSERT, UPDATE, DELETE). Операции изменения помечены как разрушительные. Поддерживается только один оператор за запрос.
  • get_schema_info — метаданные структуры: имена и типы столбцов, допустимость NULL, значения по умолчанию, комментарии.
  • get_table_sample — образец данных таблицы, до 20 строк, чтобы понять формат без больших выборок.

Ресурсы и подсказки:

  • Таблицы как ресурсы — список таблиц. В режиме нескольких баз (без MYSQL_DATABASE) — список пользовательских баз без системных.
  • MCP-промпты explore_database (обзор всей базы) и analyze_table (разбор одной таблицы с примерами запросов). В Claude Code они доступны как слэш-команды.

Также есть SSH-туннель, SSL/TLS, запросы к другим базам через запись база.таблица и подробное логирование с маскированием паролей.

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

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

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

Установка

Установка: pip install mysql-mcp-server, или запуск без установки через uvx mysql_mcp_server (нужен uv). Подключение настраивается переменными окружения: MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE (необязательна — без неё включается режим нескольких баз), а также MYSQL_SSL_MODE, параметры SSH-туннеля и транспорта (MCP_TRANSPORT=sse). При самостоятельном запуске сервер читает файл .env из рабочего каталога. Claude Code и Claude Desktop запускают его из своего каталога, поэтому значения MYSQL_* нужно указывать в блоке env конфига клиента.

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

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

claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server

Конфиг Claude Desktop запускает сервер из клона репозитория — укажите путь к нему в --directory. Для VS Code нужен установленный uv.

Проверка

Запустите промпт explore_database (в Claude Code — /mcp__mysql__explore_database): агент перечислит таблицы, покажет схемы и образцы данных.

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

Опиши структуру таблицы customers и покажи несколько строк для примера.
Посчитай заказы по статусам за последний месяц.

Риски

execute_sql разрешает не только чтение, но и INSERT, UPDATE и DELETE, так что агент может изменить или удалить данные. Авторы настаивают: заведите отдельного пользователя MySQL с минимальными правами, никогда не используйте root или административные учётные записи и ограничьте доступ только нужными операциями. Пароль храните в переменных окружения или в env клиента, не коммитьте его.

У транспорта SSE нет встроенной аутентификации, и по умолчанию он слушает 0.0.0.0. Вне localhost ставьте обратный прокси с аутентификацией и задайте MCP_SSE_HOST=127.0.0.1. Для удалённых баз используйте SSL/TLS или SSH-туннель. Лицензия — MIT.

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

Почему сервер пишет «Missing required database configuration»?

Claude Code и Claude Desktop запускают сервер не из папки проекта, поэтому .env не находится. Перенесите значения MYSQL_* в блок env конфига клиента.

Можно ли выполнить несколько запросов за раз?

Нет, поддерживается только один SQL-оператор за запрос. Для других баз используйте полные имена вида mydb.mytable.

Основы протокола — на странице что такое 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

Источники