Этот сервер MCP предоставляет базы данных MariaDB и MySQL клиентам MCP, таким как Claude Desktop, VS Code и другие совместимые инструменты.

Он предоставляет инструменты для:

• список доступных баз данных
• таблицы списков в базе данных
• описание схем таблиц
• выполнять SQL-запросы

Особенности

Безопасное по умолчанию поведение: доступ только для чтения включен по умолчанию Проверка запросов для блокирования запрещенных заявлений и снижения риска инъекций Конфигурируемые разрешения на запись через переменные среды

• Тайм-аут и защита от ограничений
• Нумерная безопасность для идентификаторов вставки и значений BIGINT, возвращенных водителем MariaDB

##Установка

Вариант 1: Установить в npm

Вариант 2: Установить локально

Вариант 3: Построение из источника

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

Установите следующие переменные среды перед запуском сервера:

• [[Т0]]: Ведущий базы данных
• [[Т1]]: Порт базы данных (по умолчанию: 3306)
• [[Т3]]: Имя пользователя базы данных
• [[Т4]]: Пароль базы данных
• [[Т5]]: Имя базы данных по умолчанию (опционально) MARIADB_ALLOW_INSERT: Включить INSERT заявления true/false [[Т10]]: Включить [[Т11]] заявления [[Т12]]/[[Т13]]

MariaDB / MySQL MCP Server

This MCP server exposes MariaDB and MySQL databases to MCP clients such as Claude Desktop, VS Code, and other compatible tools.

It provides tools to:

• list available databases
• list tables in a database
• describe table schemas
• execute SQL queries

Features

• Safe-by-default behavior: read-only access is enabled by default
• Query validation to block disallowed statements and reduce injection risk
• Configurable write permissions through environment variables
• Timeout and row-limit protection
• Numeric safety for insert IDs and BIGINT values returned by the MariaDB driver

Installation

Option 1: Install from npm

npm install -g mariadb-mcp-server

Option 2: Install locally

npm install mariadb-mcp-server

Option 3: Build from source

git clone https://github.com/rjsalgado/mariadb-mcp-server.git
cd mariadb-mcp-server
npm install
npm run build

Configuration

Set the following environment variables before starting the server:

• MARIADB_HOST: Database host
• MARIADB_PORT: Database port (default: 3306)
• MARIADB_USER: Database username
• MARIADB_PASSWORD: Database password
• MARIADB_DATABASE: Default database name (optional)
• MARIADB_ALLOW_INSERT: Enable INSERT statements (true/false)
• MARIADB_ALLOW_UPDATE: Enable UPDATE statements (true/false)
• MARIADB_ALLOW_DELETE: Enable DELETE statements (true/false)
• MARIADB_TIMEOUT_MS: Query timeout in milliseconds (default: 10000)
• MARIADB_ROW_LIMIT: Maximum number of rows returned (default: 1000)

Example:

export MARIADB_HOST=localhost
export MARIADB_PORT=3306
export MARIADB_USER=myuser
export MARIADB_PASSWORD=mypassword
export MARIADB_DATABASE=mydb
export MARIADB_ALLOW_INSERT=false
export MARIADB_ALLOW_UPDATE=false
export MARIADB_ALLOW_DELETE=false
export MARIADB_TIMEOUT_MS=10000
export MARIADB_ROW_LIMIT=1000

MCP configuration

Using npm package

{
  "mcpServers": {
    "mariadb": {
      "command": "npx",
      "args": ["mariadb-mcp-server"],
      "env": {
        "MARIADB_HOST": "your-host",
        "MARIADB_PORT": "3306",
        "MARIADB_USER": "your-user",
        "MARIADB_PASSWORD": "your-password",
        "MARIADB_DATABASE": "your-database",
        "MARIADB_ALLOW_INSERT": "false",
        "MARIADB_ALLOW_UPDATE": "false",
        "MARIADB_ALLOW_DELETE": "false",
        "MARIADB_TIMEOUT_MS": "10000",
        "MARIADB_ROW_LIMIT": "1000"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Using a built local server

{
  "mcpServers": {
    "mariadb": {
      "command": "node",
      "args": ["/absolute/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-database",
        "MARIADB_ALLOW_INSERT": "false",