MCP-сервер local-mysql

Это MCP-сервер для локальной разработки, который предоставляет доступ к базам данных MySQL для VSCode (и Copilot CLI). Он предоставляет два инструмента: query (только для SELECT) и execute (только для INSERT / UPDATE).

Этот сервер предназначен исключительно для локальной разработки. Не развертывайте его в производственной среде и не подключайте к рабочим базам данных.

Настройки подключения

Значения по умолчанию соответствуют src/main/resources/application.yml.

Пул соединений не зависит от схемы и не привязан к базе данных по умолчанию. Указывайте схему в параметре schema при каждом вызове или используйте полное имя, например oa.t_xxx. Разрешенные схемы: fo, oa, bo, cm, nepro.

Related MCP server: MySQL MCP Server

Установка и сборка

cd mcp-server
npm install
npm run build

После сборки перезапустите MCP-клиент (VSCode / Copilot CLI), чтобы перечитать настройки.

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

npm run dev

Инструменты

query — SELECT только для чтения

{
  "sql": "SELECT id, name FROM m_article WHERE id = ?",
  "params": [123],
  "schema": "fo"          // 省略可
}

Возвращаемое значение:

{
  "schema": "fo",
  "rowCount": 1,
  "truncated": false,
  "maxRows": 1000,
  "fields": [{ "name": "id", "type": 3 }, { "name": "name", "type": 253 }],
  "rows": [{ "id": 123, "name": "..." }]
}

Ограничения:

• Только один оператор (несколько операторов отклоняются)

• Должен начинаться с SELECT (в v1 CTE / WITH не поддерживаются)

• Лимит результатов: 1000 строк. Если truncated: true, это означает, что существуют дополнительные строки

execute — INSERT или UPDATE

{
  "sql": "UPDATE m_article SET name = ? WHERE id = ?",
  "params": ["new name", 123],
  "schema": "fo"
}

Возвращаемое значение:

{
  "schema": "fo",
  "affectedRows": 1,
  "insertId": 0,
  "changedRows": 1,
  "warningStatus": 0
}

Ограничения:

• Только один оператор

• Должен начинаться с INSERT или UPDATE

• DELETE, DROP, ALTER, CREATE, TRUNCATE, RENAME, GRANT, REVOKE, REPLACE, MERGE, CALL, LOAD, HANDLER, LOCK, UNLOCK, SET, USE, START, BEGIN, COMMIT, ROLLBACK, SAVEPOINT — все отклоняются

Интеграция

Клонируйте этот репозиторий рядом с проектом, который будет использовать сервер, и создайте следующую структуру каталогов:

parent/
├── mcp-local-mysql/        ← このリポジトリ
└── your-project/
    └── .vscode/mcp.json    （Copilot CLI の場合は .mcp.json）

VSCode

Добавьте .vscode/mcp.json в корень проекта. Корневой ключ — servers:

{
  "servers": {
    "local-mysql": {
      "command": "node",
      "args": ["../mcp-local-mysql/dist/index.js"],
      "env": {}
    }
  }
}

Если вы хотите переопределить учетные данные для каждого рабочего пространства, отредактируйте объект env. Например:

"env": { "FO_DB_USER": "devuser", "FO_DB_PASS": "devpass" }

Также убедитесь, что обнаружение MCP включено в .vscode/settings.json, чтобы VSCode мог распознать .vscode/mcp.json:

{
  "chat.mcp.discovery.enabled": true
}

Copilot CLI

Добавьте .mcp.json в корень проекта. Корневой ключ — mcpServers:

{
  "mcpServers": {
    "local-mysql": {
      "command": "node",
      "args": ["../mcp-local-mysql/dist/index.js"],
      "env": {}
    }
  }
}

Примечания по безопасности

• На уровне драйвера установлено multipleStatements: false (эшелонированная защита, добавленная в валидатор)

• Все запросы параметризованы — значения должны передаваться через params, не вставляйте их напрямую в SQL-строку

• Имена схем сверяются с белым списком перед вставкой в USE `...`

• Логи сервера выводятся только в stderr. stdout зарезервирован исключительно для фреймов протокола MCP