MCP Server for MySQL

MCP-сервер для доступа агента к MySQL: чтение схемы и запросы, по умолчанию только на чтение, запись включается флагами

benborla/mcp-server-mysqlАвтор:Ben Borla

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-for-mysql

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'MYSQL_HOST=<значение MYSQL_HOST>' --env 'MYSQL_PORT=<значение MYSQL_PORT>' --env 'MYSQL_USER=<значение MYSQL_USER>' --env 'MYSQL_PASS=<ваш MYSQL_PASS>' mcp_server_mysql -- npx -y @benborla29/mcp-server-mysql

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"mcp_server_mysql","type":"stdio","command":"npx","args":["-y","@benborla29/mcp-server-mysql"],"env":{"MYSQL_HOST":"<значение MYSQL_HOST>","MYSQL_PORT":"<значение MYSQL_PORT>","MYSQL_USER":"<значение MYSQL_USER>","MYSQL_PASS":"<ваш MYSQL_PASS>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "mcp_server_mysql": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Выполните в терминале

codex mcp add mcp_server_mysql --env 'MYSQL_HOST=<значение MYSQL_HOST>' --env 'MYSQL_PORT=<значение MYSQL_PORT>' --env 'MYSQL_USER=<значение MYSQL_USER>' --env 'MYSQL_PASS=<ваш MYSQL_PASS>' -- npx -y @benborla29/mcp-server-mysql

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.mcp_server_mysql]
command = "npx"
args = ["-y", "@benborla29/mcp-server-mysql"]
env = { MYSQL_HOST = "<значение MYSQL_HOST>", MYSQL_PORT = "<значение MYSQL_PORT>", MYSQL_USER = "<значение MYSQL_USER>", MYSQL_PASS = "<ваш MYSQL_PASS>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "mcp_server_mysql": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "environment": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "<значение MYSQL_HOST>",
        "MYSQL_PORT": "<значение MYSQL_PORT>",
        "MYSQL_USER": "<значение MYSQL_USER>",
        "MYSQL_PASS": "<ваш MYSQL_PASS>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MYSQL_HOSTобязательная
MYSQL_PORTобязательная
MYSQL_USERобязательная
MYSQL_PASSсекрет, обязательная
MYSQL_DBнеобязательная

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

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит b9c714e.

Текст для агента

Подключи MCP-сервер MySQL: claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="пароль" -e MYSQL_DB="база" -- npx @benborla29/mcp-server-mysql. Оставь запись выключенной.

Другие способы из описания автора

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

Пароль подставьте свой, флаги записи по умолчанию выключены.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает агента к базе MySQL по протоколу MCP. Он дает инструмент для выполнения SQL и ресурс со списком таблиц и колонок, так что агент видит схему и делает выборки без ручного экспорта. По умолчанию доступны только запросы на чтение, операции вставки, обновления и удаления включаются отдельными переменными окружения. Есть режим нескольких баз без переподключения, права по конкретной базе, маскирование чувствительных данных в результатах, подключение через SSH-туннель и SSL с mTLS. Кроме локального запуска по stdio, поддерживается удаленный режим по HTTP с токеном.

Для кого. Для разработчиков и аналитиков, которым нужно, чтобы агент читал и опрашивал MySQL прямо из редактора или клиента.

Подходит, если

Нужно, чтобы агент изучил схему базы и написал или проверил SQL
Нужно быстро получать выборки из MySQL, не выходя из редактора
Нужен доступ к удаленной базе через SSH-туннель или HTTP с токеном

Не подходит, если

Нужна другая СУБД, не MySQL
Нельзя давать агенту прямой доступ к боевой базе

Пример запроса к агенту

Покажи схему базы и посчитай заказы по месяцам за последний год

Ограничения

Нужен Node.js 20+ и учетная запись MySQL с нужными правами. Пароль и параметры подключения передаются через переменные окружения. Операции записи по умолчанию выключены и включаются флагами ALLOW_INSERT_OPERATION, ALLOW_UPDATE_OPERATION, ALLOW_DELETE_OPERATION, после чего агент может менять данные, поэтому давайте ему учетку с минимальными правами и не подключайте к боевой базе без необходимости.

Как отключить. Удалите сервер mcp_server_mysql из конфигурации MCP вашего клиента, например командой claude mcp remove или правкой блока mcpServers.

MCP

Транспорт: stdio, http
Авторизация: не нужна

Переменные окружения
Переменные окружения
MYSQL_HOST обязательная	Адрес сервера MySQL
MYSQL_PORT обязательная	Порт MySQL, обычно 3306
MYSQL_USER обязательная	Имя пользователя базы
MYSQL_PASS обязательная, секрет	Пароль пользователя базы
MYSQL_DB	Имя базы, можно не задавать в режиме нескольких баз
ALLOW_INSERT_OPERATION	Разрешить вставку, по умолчанию false
ALLOW_UPDATE_OPERATION	Разрешить обновление, по умолчанию false
ALLOW_DELETE_OPERATION	Разрешить удаление, по умолчанию false

Проверка безопасности

Подключается к базе данных и выполняет SQL по запросу агента
При включении флагов записи может изменять и удалять данные

Коротко о README

README представляет MCP-сервер, который дает Claude и другим LLM доступ к MySQL: чтение схемы, запросы и по желанию запись. Перечислены возможности: режим только на чтение по умолчанию, интеграция с Claude Code, SSH-туннель, работа с несколькими базами, права по базе, маскирование данных, удаленный режим по HTTP и SSL с mTLS. Показаны команды установки через npx для Claude Code и фрагмент конфигурации для Claude Desktop и других клиентов. Инструмент mysql_query выполняет SQL, ресурс mysql://tables отдает список таблиц. Отдельные страницы документации описывают установку, переменные окружения, режим нескольких баз, маскирование, тесты и решение проблем. Лицензия MIT.

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

Может ли агент менять данные?

По умолчанию нет, доступно только чтение. Вставка, обновление и удаление включаются отдельными переменными окружения ALLOW_INSERT_OPERATION, ALLOW_UPDATE_OPERATION и ALLOW_DELETE_OPERATION.

Как подключиться к удаленной базе?

Есть встроенная поддержка SSH-туннеля, а также удаленный режим по HTTP с токеном. Подробности в docs/INSTALLATION.md и docs/CONFIGURATION.md.

Scientific Agent Skills

Выбор редакции

166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам

СкиллСредний риск47 тыс.

MCP Toolbox for Databases

Официальный

Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml

MCP-серверВысокий риск16,5 тыс.

Hugging Face Skills

Выбор редакции

Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой

СкиллВысокий риск11,1 тыс.

Flint

Официальный

Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики

MCP-серверСредний рискБез VPN4,3 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

Scientific Agent Skills

MCP Toolbox for Databases

Hugging Face Skills

Flint