mysql-mcp

mysql-mcp

neverinfamousMIT
4 звёзд2 форков
mysql-mcp — это MCP-сервер для управления базами данных MySQL через AI-ассистентов. Он включает более 100 инструментов для выполнения SQL-запросов, управления схемами, администрирования и миграций. Сервер ориентирован на разработчиков и DevOps-инженеров, которые хотят взаимодействовать с БД напрямую из чата с AI. Главная особенность — Code Mode. Вы можете написать JavaScript-скрипт, который выполняется в изолированной среде и имеет доступ ко всем 224 операциям. Это снижает расход токенов и упрощает сложные сценарии. Сервер поддерживает OAuth 2.0, развертывание через Docker и детерминированную обработку ошибок. Кодовая база покрыта 2185 юнит-тестами и 432 E2E-тестами, покрытие 89,74%.
DatabasesCloud-devopsDocker
Открыть на GitHub

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

Общее

  • СтатусСообщество
  • Разработчикneverinfamous
  • ЛицензияMIT

Технологии

  • Языки
    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%

Поделиться