easy-mysql-mcp

Легковесный сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам проверять и запрашивать базу данных MySQL через безопасный структурированный интерфейс инструментов.

Этот проект использует Node.js, TypeScript, официальный SDK MCP и mysql2/promise. Он работает через stdio, поэтому его можно напрямую использовать в MCP-клиентах, таких как Claude Desktop.

Функции

• Пул соединений MySQL на базе mysql2/promise

• Инструмент для выполнения запросов только для чтения для получения данных

• Инструмент выполнения для операторов изменения данных

• Инструменты обнаружения схемы для таблиц, представлений, индексов и триггеров

• Проверка плана выполнения запроса с помощью EXPLAIN

• Проверка текущего пользователя и привилегий

• Защита stdout для предотвращения засорения протокола stdio логами, не относящимися к MCP

Требования

• Node.js 18 или новее

• npm

• Доступная база данных, совместимая с MySQL

Установка

Запустите сервер напрямую с помощью npx:

npx -y easy-mysql-mcp

Для локальной разработки после клонирования репозитория:

cd easy-mysql-mcp
npm install
npm run build

Конфигурация

Настройте сервер с помощью переменных окружения. Вы можете предоставить их через конфигурацию вашего MCP-клиента или создав локальный файл .env.

Пример .env:

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

Использование

Настройте ваш MCP-клиент для запуска пакета через npx.

Для локальной разработки сначала соберите исходный код TypeScript:

npm run build

Запустите MCP-сервер:

npm start

Сервер обменивается данными через stdio и обычно запускается MCP-клиентом, а не вручную.

Пример для Claude Desktop

Добавьте сервер в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "easy-mysql-mcp": {
      "command": "npx",
      "args": ["-y", "easy-mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Перезапустите Claude Desktop после обновления конфигурации.

Доступные инструменты

Примечания по безопасности

• Используйте выделенного пользователя MySQL с минимальными правами, необходимыми вашему ассистенту.

• Отдавайте предпочтение учетным данным базы данных только для чтения, если вам нужна только проверка и отчетность.

• Будьте осторожны с mysql_execute, так как это может изменить данные.

• Не добавляйте файлы .env или реальные учетные данные базы данных в GitHub.

• Проверяйте сгенерированный SQL перед запуском на производственных данных.

Разработка

npm run dev

Это запускает TypeScript в режиме наблюдения.

Для создания производственной сборки:

npm run build

Структура проекта

src/
  db.ts       MySQL pool and query helpers
  index.ts    MCP server and tool registration
  proxy.ts    stdout protection for stdio-based MCP transport

Лицензия

ISC