io.github.gistrec由 GitHub 帳號 gistrec 發布v1.1.1更新於 Nov 5, 2026
MCP server for one MySQL database: schema, read-only queries and guarded writes.
本機 MCP 伺服器，綁定單一 MySQL 或 MariaDB 資料庫，讓助理檢視結構、執行唯讀查詢與執行計畫，並可選擇性執行受控寫入。
Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
MySQL MCP подключает AI-приложение к одной базе MySQL или MariaDB: посмотреть структуру, задать вопрос данным на естественном языке, разобраться в медленном запросе — и, если вы сами это разрешили, изменить данные.
Сервер привязан к одной базе: она задана конфигурацией, и ни один инструмент не может уйти в другую. По умолчанию доступно только чтение.
DELETE в читающем инструменте будет отклонён, даже если права на запись включены.START TRANSACTION READ ONLY — запись отклонит сама MySQL, даже если разбор SQL кто-то обманет.truncated.Начните с запроса, который только читает данные:
Покажи структуру базы и посчитай, сколько записей появилось за последнюю неделю.
Claude Code:
Или в .mcp.json / claude_desktop_config.json:
Один сервер — одна база. Нужно несколько баз: добавьте несколько записей со своими учётными данными; так права остаются изолированными, и сервер, подключённый к тестовой базе, физически не видит боевую.
По умолчанию — ничего: сервер стартует в режиме только чтения. Запись включается по одной операции:
Что при этом остаётся невозможным:
CREATE, ALTER, DROP, TRUNCATE, RENAME — ни при каких настройках.SET, CALL, PREPARE, LOAD DATA, блокировки, GRANT и прочее, что меняет смысл следующего запроса или выполняет непроверенный текст.SELECT ... INTO OUTFILE — запись файла на сервер базы.UPDATE и DELETE без WHERE — требуют явного подтверждения allow_full_table=true в вызове.Права MySQL — отдельное ограничение поверх этого. Разрешение ALLOW_UPDATE_OPERATION ничего не добавляет пользователю, у которого нет GRANT UPDATE. Рабочая практика: отдельный пользователь с минимальными правами, а не root.
Пароль в конфигурации MCP-клиента лежит открытым текстом. MYSQL_PASS_FILE позволяет держать его в файле с нужными правами.
@benborla29/mcp-server-mysqlИмена переменных совпадают, поэтому достаточно заменить пакет в команде запуска:
Что изменится в поведении:
MYSQL_DB обязателен — сервер всегда привязан к одной базе;MYSQL_MAX_ROWS и помечаются truncated;UPDATE/DELETE без WHERE требуют подтверждения в вызове;query, execute, explain, list_tables, describe_table, server_info.Первым делом — server_info: он покажет, к чему подключён сервер, какие права у пользователя MySQL и какие ограничения включены.
來源：README.md，提交 39810eb
Сведения о подключении и правах
Показывает, к какой базе и под каким пользователем подключён сервер, версию MySQL, размер базы, выданные пользователю права (GRANT) и действующие ограничения самого MCP-сервера: разрешённые операции записи, потолок строк в ответе и таймаут запроса. Стоит вызвать первым, если непонятно, почему запрос отклонён: права MySQL и разрешения сервера — это два независимых ограничения.
無需輸入參數。
Список таблиц базы
Перечисляет таблицы и представления подключённой базы: движок, кодировку, комментарий, размер данных и индексов в байтах и оценку числа строк. Оценка берётся из статистики InnoDB и может заметно расходиться с реальностью — точное число даёт COUNT(*) через query. С этого инструмента стоит начинать знакомство с незнакомой базой.
無需輸入參數。
Структура таблицы
Показывает структуру таблицы: столбцы с типами, обнуляемостью, значениями по умолчанию и комментариями, индексы с их составом, внешние ключи наружу и, главное, ссылки на эту таблицу из других (referenced_by) — именно они определяют, безопасно ли удалять строки. Разделы, кроме столбцов, можно отключить, если нужен только их список.
table必填include_indexesinclude_foreign_keysВыполнить читающий SQL-запрос
Выполняет один читающий запрос (SELECT, SHOW, DESCRIBE, WITH ... SELECT) и возвращает строки. Изменяющие запросы отклоняются даже при включённых правах на запись — для них есть execute. Запрос идёт внутри read-only транзакции, число строк ограничено MYSQL_MAX_ROWS: если ответ обрезан, поле truncated равно true и это префикс, а не весь результат. Значения подставляйте через ? и params — драйвер экранирует их сам.
sql必填limitparamsПоказать план выполнения запроса
Возвращает план выполнения читающего запроса: какие индексы будут использованы и сколько строк сервер рассчитывает просмотреть. Обычный режим ничего не выполняет; analyze=true запускает запрос по-настоящему и показывает фактическое время — на больших таблицах это дорого. Полезно перед тяжёлой выборкой и при диагностике медленных запросов.
sql必填formatparamsanalyzeВыполнить изменяющий SQL-запрос
Выполняет один изменяющий запрос — 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.
sql必填paramsallow_full_table已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
claude mcp add mysql-myapp \ -e MYSQL_HOST=db.example.com \ -e MYSQL_USER=myapp_ro \ -e MYSQL_PASS='пароль' \ -e MYSQL_DB=myapp \ -e MYSQL_SSL=true \ -- npx -y mcp-mysql-client{ "mcpServers": { "mysql-myapp": { "command": "npx", "args": ["-y", "mcp-mysql-client"], "env": { "MYSQL_HOST": "db.example.com", "MYSQL_PORT": "3306", "MYSQL_USER": "myapp_ro", "MYSQL_PASS": "пароль", "MYSQL_DB": "myapp", "MYSQL_SSL": "true" } } }}"ALLOW_INSERT_OPERATION": "true","ALLOW_UPDATE_OPERATION": "true","ALLOW_DELETE_OPERATION": "false"- "args": ["-y", "@benborla29/mcp-server-mysql"]+ "args": ["-y", "mcp-mysql-client"]