mysql-mcp

mysql-mcp

neverinfamousv5.1.2MIT
11 звёзд2 форков
mysql-mcp — это MCP-сервер для управления базами данных MySQL через AI-ассистентов. Он включает более 100 инструментов для выполнения SQL-запросов, управления схемами, администрирования и миграций. Сервер ориентирован на разработчиков и DevOps-инженеров, которые хотят взаимодействовать с БД напрямую из чата с AI. Главная особенность — Code Mode. Вы можете написать JavaScript-скрипт, который выполняется в изолированной среде и имеет доступ ко всем 224 операциям. Это снижает расход токенов и упрощает сложные сценарии. Сервер поддерживает OAuth 2.0, развертывание через Docker и детерминированную обработку ошибок. Кодовая база покрыта 2185 юнит-тестами и 432 E2E-тестами, покрытие 89,74%.
  • Сервер сообщества
  • Локальный запуск (stdio)
  • TypeScript
  • Лицензия MIT
  • Обновлён 16 ноября 2026 г.
Подключение

Подключить mysql-mcp

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "mysql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@neverinfamous/mysql-mcp",
        "--transport",
        "stdio",
        "--tool-filter",
        "codemode"
      ],
      "env": {
        "MYSQL_HOST": "<MYSQL_HOST>",
        "MYSQL_PORT": "<MYSQL_PORT>",
        "MYSQL_USER": "<MYSQL_USER>",
        "MYSQL_PASSWORD": "<MYSQL_PASSWORD>",
        "MYSQL_DATABASE": "<MYSQL_DATABASE>"
      }
    }
  }
}

Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикneverinfamous
  • Версияv5.1.2
  • ЛицензияMIT
  • Последний релиз05.11.2026
  • Активность источника16.11.2026

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio — локальный запуск

Описание

Возможности

  • Выполняйте произвольные SQL-запросы — SELECT, INSERT, UPDATE, DELETE — и получайте результаты в структурированном виде.
  • Управляйте схемами: создавайте, изменяйте и удаляйте таблицы, индексы, представления и хранимые процедуры.
  • Используйте Code Mode для комплексных операций: пишите сценарии на JavaScript с доступом ко всем инструментам сервера без множественных вызовов.
  • Настраивайте безопасное подключение через OAuth 2.0 и управление токенами.
  • Развёртывайте сервер в Docker за две команды: docker pull и docker run.
  • Подключайтесь к MySQL через переменные окружения: хост, порт, пользователь, пароль, база данных.
  • Автоматизируйте миграции: добавление колонок, изменение типов, создание внешних ключей и переименование полей.
  • Просматривайте метаданные базы: список таблиц, колонки, индексы, связи между таблицами.
  • Интегрируйтесь с любыми MCP-клиентами — Claude Desktop, Cursor, AntiGravity и пользовательскими клиентами.
  • Получайте детерминированные сообщения об ошибках для быстрой отладки запросов и сценариев.

Как подключить

1. Установите сервер глобально через npm:

npm install -g @neverinfamous/mysql-mcp

Или используйте Docker:

docker pull writenotenow/mysql-mcp

2. Настройте подключение к MySQL через переменные окружения. Для Claude Desktop добавьте в конфигурационный файл следующий блок:

{ "mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@neverinfamous/mysql-mcp"], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USER": "dbuser", "MYSQL_PASSWORD": "secret", "MYSQL_DATABASE": "production_db" } } } }

Для Docker-развёртывания используйте команду docker run:

{ "mcpServers": { "mysql": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "MYSQL_HOST=host.docker.internal", "-e", "MYSQL_USER=user", "-e", "MYSQL_PASSWORD=pass", "-e", "MYSQL_DATABASE=db", "writenotenow/mysql-mcp"], "env": {} } } }

3. Перезапустите клиент (Claude Desktop, Cursor и другие). После перезапуска в списке инструментов появятся все возможности сервера.

Примеры запросов

  • «Покажи структуру базы: список таблиц, их колонки, типы данных и индексы».
  • «Найди всех пользователей, которые зарегистрировались, но не подтвердили email, и симулируй отправку напоминания».
  • «Создай таблицу logs с автоинкрементом, временной меткой и текстовым полем, добавь индекс по метке».
  • «Выполни миграцию: переименуй колонку last_name в surname в таблице employees, сохранив данные».

Технические детали

  • Язык реализации: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, Cursor, AntiGravity и любые MCP-клиенты, поддерживающие stdio
  • Развертывание: npm-пакет или Docker-образ
  • Тестирование: 2185 юнит-тестов, 432 E2E-теста, покрытие 89,74%

Поделиться