Servidor MCP local-mysql

Un servidor MCP para desarrollo local que expone bases de datos MySQL a VSCode (y Copilot CLI). Proporciona dos herramientas: query (solo para SELECT) y execute (solo para INSERT / UPDATE).

Este servidor es solo para desarrollo local. No lo despliegue en entornos de producción ni lo conecte a bases de datos de producción.

Configuración de conexión

Los valores predeterminados coinciden con src/main/resources/application.yml.

El pool de conexiones es independiente del esquema y no está vinculado a una base de datos predeterminada. Especifique el esquema con el parámetro schema en cada llamada o utilice nombres totalmente calificados como oa.t_xxx. Esquemas permitidos: fo, oa, bo, cm, nepro.

Related MCP server: MySQL MCP Server

Instalación y compilación

cd mcp-server
npm install
npm run build

Después de compilar, reinicie el cliente MCP (VSCode / Copilot CLI) para volver a cargar la configuración.

Si desea realizar un desarrollo iterativo sin necesidad de recompilar:

npm run dev

Herramientas

query — SELECT de solo lectura

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

Valor de retorno:

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

Restricciones:

• Solo una única sentencia (se rechazan múltiples sentencias)

• Debe comenzar con SELECT (CTE / WITH no son compatibles en v1)

• Límite de resultados: 1000 filas. Si truncated: true, indica que existen más filas

execute — INSERT o UPDATE

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

Valor de retorno:

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

Restricciones:

• Solo una única sentencia

• Debe comenzar con INSERT o UPDATE

• DELETE, DROP, ALTER, CREATE, TRUNCATE, RENAME, GRANT, REVOKE, REPLACE, MERGE, CALL, LOAD, HANDLER, LOCK, UNLOCK, SET, USE, START, BEGIN, COMMIT, ROLLBACK, SAVEPOINT — todos rechazados

Cómo integrarlo

Clone este repositorio junto al proyecto que utilizará este servidor y mantenga la siguiente estructura de directorios:

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

VSCode

Agregue .vscode/mcp.json en la raíz del proyecto. La clave raíz es servers:

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

Si desea sobrescribir las credenciales para cada espacio de trabajo, edite el objeto env. Ejemplo:

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

Además, asegúrese de habilitar el descubrimiento de MCP en .vscode/settings.json para que VSCode pueda reconocer .vscode/mcp.json:

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

Copilot CLI

Agregue .mcp.json en la raíz del proyecto. La clave raíz es mcpServers:

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

Notas de seguridad

• multipleStatements: false configurado a nivel de controlador (defensa en profundidad añadida al validador)

• Todas las consultas están parametrizadas: los valores deben pasarse siempre a través de params, no los incruste directamente en la cadena SQL

• Los nombres de esquema se comparan con una lista blanca antes de ser incrustados en USE `...`

• Los registros del servidor se envían solo a stderr. stdout está reservado exclusivamente para los marcos del protocolo MCP