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 с минимальными правами.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.