MariaDB MCP Server

by bretoreta

Integrations

  • Provides access to MariaDB databases, allowing users to list databases, explore table schemas, and execute read-only SQL queries with security features like query validation and resource limits.

  • Enables interaction with MySQL databases through capabilities to list available databases, browse tables, describe table structures, and run SQL queries with built-in security controls.

Доступ к базе данных MariaDB / MySQL MCP-сервер

Этот сервер MCP обеспечивает доступ к базам данных MariaDB/MySQL.

Это позволяет вам:

  • Список доступных баз данных
  • Список таблиц в базе данных
  • Опишите схемы таблиц
  • Выполнение SQL-запросов

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

  • Доступ только для чтения По умолчанию : ВЫБРАТЬ, ПОКАЗАТЬ, ОПИСАТЬ и ОБЪЯСНИТЬ
  • Проверка запроса : предотвращает внедрение SQL-кода и блокирует любые попытки изменения данных.
  • Тайм-аут запроса : предотвращает потребление ресурсов длительными запросами.
  • Ограничение по количеству строк : предотвращает возврат избыточных данных.

Установка

Вариант 1: Сборка из исходного кода

# Clone the repository git clone https://github.com/bretoreta/mariadb-mcp-server.git cd mariadb-mcp-server # Install dependencies and build pnpm install pnpm run build

2. Настройте переменные среды

Серверу требуются следующие переменные среды:

  • MARIADB_HOST: Имя хоста сервера базы данных
  • MARIADB_PORT: Порт сервера базы данных (по умолчанию: 3306)
  • MARIADB_USER: Имя пользователя базы данных
  • MARIADB_PASSWORD: Пароль базы данных
  • MARIADB_DATABASE: Имя базы данных по умолчанию (необязательно)
  • MARIADB_ALLOW_INSERT: ложь
  • MARIADB_ALLOW_UPDATE: ложь
  • MARIADB_ALLOW_DELETE: ложь
  • MARIADB_TIMEOUT_MS: 10000
  • MARIADB_ROW_LIMIT: 1000

3. Добавить в настройки MCP

Добавьте следующую конфигурацию в файл настроек MCP:

Если вы собрали из исходников:

{ "mcpServers": { "mariadb": { "command": "node", "args": ["/path/to/mariadb-mcp-server/dist/index.js"], "env": { "MARIADB_HOST": "your-host", "MARIADB_PORT": "3306", "MARIADB_USER": "your-user", "MARIADB_PASSWORD": "your-password", "MARIADB_DATABASE": "your-default-database", "MARIADB_ALLOW_INSERT": "false", "MARIADB_ALLOW_UPDATE": "false", "MARIADB_ALLOW_DELETE": "false", "MARIADB_TIMEOUT_MS": "10000", "MARIADB_ROW_LIMIT": "1000", }, "disabled": false, "autoApprove": [] } } }

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

список_баз_данных

Список всех доступных баз данных на сервере MariaDB / MySQL. Параметры : Нет

Пример :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "list_databases" } }

список_таблиц

Перечисляет все таблицы в указанной базе данных.

Параметры :

  • database (необязательно): Имя базы данных (используется по умолчанию, если не указано иное)

Пример :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "list_tables", "database": "my_database_name" } }

описать_таблицу

Показывает схему для конкретной таблицы.

Параметры :

  • database (необязательно): Имя базы данных (используется по умолчанию, если не указано иное)
  • table (обязательно): Название таблицы

Пример :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "describe_table", "database": "my_database_name" } }

выполнить_запрос

Выполняет SQL-запрос.

Параметры :

  • query (обязательно): SQL-запрос
  • database (необязательно): Имя базы данных (используется по умолчанию, если не указано иное)

Пример :

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "sessionId": "session_id from /sse call", "name": "execute_query", "query": "SELECT * FROM my_table LIMIT 10" } }

Тестирование

Сервер автоматически тестирует MariaDB для проверки ее функциональности с вашей настройкой MariaDB:

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

Если у вас возникли проблемы:

  1. Проверьте журналы сервера на наличие сообщений об ошибках.
  2. Проверьте свои учетные данные MariaDB и данные подключения
  3. Убедитесь, что у вашего пользователя MariaDB есть соответствующие разрешения.
  4. Убедитесь, что ваш запрос доступен только для чтения и правильно отформатирован.

Вдохновение https://github.com/rjsalgado/mariadb-mcp-server

Лицензия

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

-
security - not tested
F
license - not found
-
quality - not tested

Обеспечивает безопасный доступ только для чтения к базам данных MariaDB/MySQL, позволяя пользователям просматривать базы данных, исследовать схемы таблиц и выполнять SQL-запросы с помощью встроенных мер безопасности.

  1. Функции безопасности
    1. Установка
      1. Вариант 1: Сборка из исходного кода
      2. 2. Настройте переменные среды
      3. 3. Добавить в настройки MCP
    2. Доступные инструменты
      1. список_баз_данных
      2. список_таблиц
      3. описать_таблицу
      4. выполнить_запрос
    3. Тестирование
      1. Поиск неисправностей
        1. Лицензия

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Enables interaction with a MySQL database via JSON commands, supporting read-only queries, test execution of write queries, and table information retrieval through Docker.
            Last updated -
            4
            5
            5
            JavaScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
            Last updated -
            1,363
            350
            TypeScript
            MIT License
            • Linux
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries.
            Last updated -
            1,363
            MIT License
          • -
            security
            A
            license
            -
            quality
            An MCP server implementation that enables Claude to execute read-only queries against MariaDB databases and explore database schemas through natural language.
            Last updated -
            5
            Python
            MIT License
            • Apple

          View all related MCP servers

          ID: 9tru29x6wk