Skip to main content
Glama
mcp-mysql-client

mcp-mysql-client

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MYSQL_DBNoБаза данных (обязательно, синоним MYSQL_DATABASE)
MYSQL_SSLNoТребовать TLSfalse
MYSQL_HOSTNoХост сервера127.0.0.1
MYSQL_PASSNoПароль (синоним MYSQL_PASSWORD)
MYSQL_PORTNoПорт3306
MYSQL_USERYesПользователь (обязательно)
MYSQL_SSL_CANoПуть к корневому сертификату; сам по себе включает TLS
MYSQL_DATABASENoБаза данных (синоним MYSQL_DB)
MYSQL_MAX_ROWSNoПотолок строк в одном ответе1000
MYSQL_PASSWORDNoПароль (синоним MYSQL_PASS)
MYSQL_PASS_FILENoПрочитать пароль из файла вместо переменной
MYSQL_POOL_SIZENoСоединений в пуле3
ASKADS_TELEMETRYNo0 отключает анонимную статистику запусков и вызовов инструментов
MYSQL_TIMEOUT_MSNoТаймаут запроса30000
MYSQL_MAX_RETRIESNoПовторы при обрыве связи и взаимных блокировках2
MYSQL_SOCKET_PATHNoUnix-сокет вместо host/port
MYSQL_READ_ONLY_TXNoВыполнять чтение в read-only транзакцииtrue
ALLOW_DELETE_OPERATIONNoРазрешить DELETEfalse
ALLOW_INSERT_OPERATIONNoРазрешить INSERTfalse
ALLOW_UPDATE_OPERATIONNoРазрешить UPDATEfalse
MYSQL_CONNECT_TIMEOUT_MSNoТаймаут подключения10000
MYSQL_SSL_REJECT_UNAUTHORIZEDNoПроверять сертификат сервераtrue

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

ВНИМАНИЕ: подключение к MySQL не настроено — не заданы MYSQL_USER, MYSQL_DB, поэтому любой вызов инструмента вернёт ошибку. Подключиться из диалога нельзя: оператор должен задать переменные окружения в конфигурации MCP-клиента — MYSQL_HOST (или MYSQL_SOCKET_PATH), MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB, при необходимости MYSQL_SSL=true и MYSQL_SSL_CA — и перезапустить сервер: переменные читаются только при старте. MySQL: сервер подключён к одной базе данных (undefined), сменить её из диалога нельзя. Читающие запросы выполняет query, план — explain, структуру дают list_tables и describe_table, сведения о подключении и правах — server_info. Тип запроса определяет сам сервер, разбирая SQL: изменяющий запрос в query будет отклонён, даже если права на запись включены. Разрешено сейчас: только чтение; DDL (CREATE, ALTER, DROP, TRUNCATE) недоступен всегда. Расширить права из диалога невозможно — они задаются переменными ALLOW_*_OPERATION в конфигурации MCP-клиента и читаются при старте. Права самой MySQL — отдельное ограничение поверх этого: отказ с errno 1142 снимается только GRANT. Ответ ограничен 1000 строками: если в результате truncated=true, это префикс, а не весь набор — уточняйте запрос или считайте агрегатами, а не подставляйте усечённые данные в выводы. Запрос прерывается через 30000 мс. Значения передавайте через ? и params: подстановка выполняется драйвером и не ломается на кавычках. Запись выполняется сразу и без транзакции — откатить её отсюда нельзя, поэтому перед UPDATE и DELETE стоит проверить выборку через query.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
server_infoA

Показывает, к какой базе и под каким пользователем подключён сервер, версию MySQL, размер базы, выданные пользователю права (GRANT) и действующие ограничения самого MCP-сервера: разрешённые операции записи, потолок строк в ответе и таймаут запроса. Стоит вызвать первым, если непонятно, почему запрос отклонён: права MySQL и разрешения сервера — это два независимых ограничения.

list_tablesA

Перечисляет таблицы и представления подключённой базы: движок, кодировку, комментарий, размер данных и индексов в байтах и оценку числа строк. Оценка берётся из статистики InnoDB и может заметно расходиться с реальностью — точное число даёт COUNT(*) через query. С этого инструмента стоит начинать знакомство с незнакомой базой.

describe_tableA

Показывает структуру таблицы: столбцы с типами, обнуляемостью, значениями по умолчанию и комментариями, индексы с их составом, внешние ключи наружу и, главное, ссылки на эту таблицу из других (referenced_by) — именно они определяют, безопасно ли удалять строки. Разделы, кроме столбцов, можно отключить, если нужен только их список.

queryA

Выполняет один читающий запрос (SELECT, SHOW, DESCRIBE, WITH ... SELECT) и возвращает строки. Изменяющие запросы отклоняются даже при включённых правах на запись — для них есть execute. Запрос идёт внутри read-only транзакции, число строк ограничено MYSQL_MAX_ROWS: если ответ обрезан, поле truncated равно true и это префикс, а не весь результат. Значения подставляйте через ? и params — драйвер экранирует их сам.

explainA

Возвращает план выполнения читающего запроса: какие индексы будут использованы и сколько строк сервер рассчитывает просмотреть. Обычный режим ничего не выполняет; analyze=true запускает запрос по-настоящему и показывает фактическое время — на больших таблицах это дорого. Полезно перед тяжёлой выборкой и при диагностике медленных запросов.

executeA

Выполняет один изменяющий запрос — INSERT, UPDATE, DELETE или REPLACE — и возвращает число затронутых строк. Сейчас сервер разрешает: только чтение. Права выдаются переменными ALLOW_INSERT_OPERATION, ALLOW_UPDATE_OPERATION и ALLOW_DELETE_OPERATION в конфигурации MCP-клиента и требуют перезапуска сервера — из диалога их получить нельзя. DDL (CREATE, ALTER, DROP, TRUNCATE) не поддерживается ни при каких настройках. Запрос выполняется сразу и без транзакции: откатить его отсюда нельзя. UPDATE и DELETE без WHERE и LIMIT требуют явного allow_full_table=true.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: server_info covers connection state, list_tables and describe_table cover schema discovery, query executes read-only SQL, explain returns execution plans, and execute handles mutations. The only mild overlap is between query and explain, but their outputs and use cases are sufficiently different that an agent should not select the wrong one.

Naming Consistency3/5

The tool names are all lowercase and readable, but they do not follow one consistent pattern: list_tables and describe_table use verb_noun, explain and execute are bare verbs, while server_info and query are noun-style names. This is a mixed convention rather than a chaotic one, but it still falls short of a uniform naming scheme.

Tool Count5/5

Six tools is a well-scoped set for a MySQL client server. Each tool covers a distinct part of the interaction surface: server diagnostics, table enumeration, schema inspection, read queries, query planning, and write execution, so none feel redundant or missing.

Completeness5/5

The tool set covers the full expected workflow for a MySQL client: understand the environment, discover tables, inspect schema, run read queries, analyze plans, and perform DML writes. DDL and transactions are explicitly excluded by design, so their absence is not an unexpected gap within the server's declared scope.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues