Skip to main content
Glama
deenesjakoruzh

MySQL Navigator MCP

by Medsaad
GitHub
Python
MIT License
6
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MySQL Навигатор MCP

Мощный инструмент навигации по базам данных MySQL/MariaDB, использующий MCP (протокол управления моделью) для простого выполнения запросов и управления базами данных.

Функции

  • Подключайтесь к базам данных MySQL/MariaDB

  • Динамическое переключение между различными базами данных

  • Выполнение SQL-запросов с безопасностью типов

  • Извлечь информацию о схеме базы данных

  • Проверка пидантической модели для параметров запроса

  • Безопасное управление учетными данными

  • Комплексная система регистрации

  • Механизмы объединения соединений и повторных попыток

  • Поддержка SSL/TLS для безопасных соединений

Расположение файла журнала (кроссплатформенное)

По умолчанию все журналы записываются в:

  • Windows: C:\Users\<YourUsername>\.mcp\mcp-db.log

  • macOS/Linux: /home/<yourusername>/.mcp/mcp-db.log или /Users/<yourusername>/.mcp/mcp-db.log

Если папка .mcp отсутствует в вашем домашнем каталоге, приложение автоматически ее создаст. Если у вас возникнут какие-либо проблемы, вы можете вручную создать папку:

Окна:

mkdir $env:USERPROFILE\.mcp

macOS/Linux:

mkdir -p ~/.mcp

Установка

Из PyPI (рекомендуется для большинства пользователей):

pip install mcp-db-navigator

Из источника (для разработки):

git clone <your-repo-url> cd mcp-db pip install -e .

  1. Создайте файл .env с учетными данными вашей базы данных:

DB_HOST=your_host DB_PORT=your_port DB_NAME=your_database_name DB_USER=your_username DB_PASSWORD=your_password DB_SSL_CA=/path/to/ssl/ca.pem # Optional: for SSL/TLS connections DB_MAX_RETRIES=3 # Optional: number of connection retries DB_RETRY_DELAY=1.0 # Optional: delay between retries in seconds

Примеры использования

1. Командная строка

Запустите сервер MCP прямо с вашего терминала:

mcp-db --config /path/to/your/project/.env

2. В курсоре

Чтобы использовать этот MCP-сервер в Cursor :

  • Откройте настройки курсора и добавьте новый сервер MCP.

  • Используйте следующую конфигурацию (пример):

{ "mcpServers": { "mysql-navigator": { "command": "mcp-db", "args": [ "--config", "/absolute/path/to/your/.env" ] } } }

  • Убедитесь, что путь к файлу .env является абсолютным.

3. В Клоде Десктоп

Если Claude Desktop поддерживает серверы MCP:

  • Добавьте новый сервер MCP и укажите его в команде mcp-db с аргументом --config , как указано выше.

  • Подробную информацию о добавлении пользовательских серверов MCP смотрите в документации Claude Desktop.

Параметры запроса

Словарь запросов поддерживает следующие параметры:

  • table_name (обязательно): Имя таблицы для запроса

  • select_fields (необязательно): Список полей для выбора (по умолчанию ["*"])

  • where_conditions (необязательно): Словарь пар поле-значение для предложения WHERE

  • order_by (необязательно): Список полей для сортировки

  • order_direction (необязательно): Направление сортировки «ASC» или «DESC» (по умолчанию: «ASC»)

  • limit (необязательно): количество возвращаемых записей

  • offset (необязательно): количество записей, которые нужно пропустить

  • group_by (необязательно): Список полей для группировки

  • having (необязательно): Словарь пар поле-значение для предложения HAVING

  • join_table (необязательно): Имя таблицы, к которой нужно присоединиться

  • join_type (необязательно): Тип операции JOIN (по умолчанию: «INNER»)

  • join_conditions (необязательно): Словарь условий соединения

Функции безопасности

  • Учетные данные базы данных управляются через файл конфигурации.

  • В моделях Pydantic пароли хранятся как SecretStr.

  • Проверка входных данных для всех параметров запроса

  • Предотвращение SQL-инъекций с помощью параметризованных запросов

  • Поддержка SSL/TLS для зашифрованных соединений

  • Очистка строки подключения

  • Ограничение скорости запросов

  • Очистка параметров запроса

Особенности производства

Обработка ошибок

  • Комплексная обработка ошибок при работе с базами данных

  • Обработка тайм-аута соединения

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

  • Проверка ввода всех параметров

Производительность

  • Объединение подключений для оптимального использования ресурсов

  • Регистрация времени выполнения запроса

  • Статистика пула подключений

  • Сбор показателей производительности

Мониторинг

  • Структурированное ведение журнала с различными уровнями ведения журнала

  • Отслеживание выполнения запроса

  • Мониторинг состояния соединения

  • Отслеживание частоты ошибок

Внося вклад

  1. Форк репозитория

  2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

  3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

  4. Отправить в ветку ( git push origin feature/amazing-feature )

  5. Открыть запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

MySQL Навигатор MCP

  1. Функции
    1. Расположение файла журнала (кроссплатформенное)
      1. Установка
        1. Из PyPI (рекомендуется для большинства пользователей):
        2. Из источника (для разработки):
      2. Примеры использования
        1. 1. Командная строка
        2. 2. В курсоре
        3. 3. В Клоде Десктоп
      3. Параметры запроса
        1. Функции безопасности
          1. Особенности производства
            1. Обработка ошибок
            2. Производительность
            3. Мониторинг
          2. Внося вклад
            1. Лицензия

              Related MCP Servers

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Medsaad/mcp-db-navigator'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server