MySQL MCP

MySQL MCP conecta una aplicación de IA a una base de datos MySQL o MariaDB: ver la estructura, hacer preguntas a los datos en lenguaje natural, entender una consulta lenta y, si usted mismo lo ha permitido, modificar los datos.

El servidor está vinculado a una sola base de datos: está definida por la configuración, y ninguna herramienta puede acceder a otra. Por defecto, solo está disponible la lectura.

• 6 herramientas. Conexión y permisos, lista de tablas, estructura de tabla, consulta de lectura, plan de consulta, consulta de modificación.

• El tipo de consulta lo determina el servidor. El SQL se analiza antes de la conexión: DELETE en la herramienta de lectura será rechazado, incluso si los permisos de escritura están habilitados.

• La lectura no puede escribir. Las consultas de lectura se ejecutan dentro de START TRANSACTION READ ONLY — la escritura será rechazada por el propio MySQL, incluso si alguien engaña al análisis SQL.

• La respuesta no desbordará el contexto. Las filas se leen en flujo y se cortan en el límite, no se descargan completas; en la respuesta hay un indicador honesto truncated.

• Permisos solo desde fuera. INSERT, UPDATE y DELETE se habilitan mediante variables de entorno y requieren reinicio — no se pueden obtener desde el diálogo. DDL no está disponible siempre.

Comience con una consulta que solo lea datos:

Muestra la estructura de la base de datos y calcula cuántos registros han aparecido en la última semana.

Inicio rápido

Claude Code:

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

O en .mcp.json / claude_desktop_config.json:

{
  "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"
      }
    }
  }
}

Un servidor — una base de datos. Si necesita varias bases: agregue varias entradas con sus propias credenciales; así los permisos permanecen aislados, y el servidor conectado a la base de pruebas no ve físicamente la de producción.

Related MCP server: MySQL MCP Server

Qué se puede encargar

Qué puede cambiar

Por defecto, nada: el servidor arranca en modo solo lectura. La escritura se habilita operación por operación:

"ALLOW_INSERT_OPERATION": "true",
"ALLOW_UPDATE_OPERATION": "true",
"ALLOW_DELETE_OPERATION": "false"

Lo que sigue siendo imposible:

• DDL — CREATE, ALTER, DROP, TRUNCATE, RENAME — bajo ninguna configuración.

• Cambio de base de datos, SET, CALL, PREPARE, LOAD DATA, bloqueos, GRANT y cualquier otra cosa que cambie el significado de la siguiente consulta o ejecute texto no verificado.

• SELECT ... INTO OUTFILE — escritura de un archivo en el servidor de la base de datos.

• UPDATE y DELETE sin WHERE — requieren confirmación explícita allow_full_table=true en la llamada.

• Varias instrucciones en una sola llamada — se ejecuta exactamente una.

Los permisos de MySQL son una restricción adicional sobre esto. El permiso ALLOW_UPDATE_OPERATION no agrega nada a un usuario que no tiene GRANT UPDATE. Buena práctica: un usuario separado con permisos mínimos, no root.

Variables de entorno

La contraseña en la configuración del cliente MCP está en texto plano. MYSQL_PASS_FILE permite mantenerla en un archivo con los permisos adecuados.

Migración desde @benborla29/mcp-server-mysql

Los nombres de las variables coinciden, por lo que basta con reemplazar el paquete en el comando de inicio:

-  "args": ["-y", "@benborla29/mcp-server-mysql"]
+  "args": ["-y", "mcp-mysql-client"]

Qué cambiará en el comportamiento:

• MYSQL_DB es obligatorio — el servidor siempre está vinculado a una sola base de datos;

• las respuestas están limitadas por MYSQL_MAX_ROWS y se marcan como truncated;

• DDL no está disponible incluso con permisos de escritura habilitados;

• UPDATE/DELETE sin WHERE requieren confirmación en la llamada;

• el conjunto de herramientas es diferente: query, execute, explain, list_tables, describe_table, server_info.

Diagnóstico

Lo primero — server_info: mostrará a qué está conectado el servidor, qué permisos tiene el usuario de MySQL y qué restricciones están habilitadas.

Documentación técnica

• Herramientas — parámetros y respuestas

• Desarrollo — compilación, pruebas, verificación en vivo

• Publicación — lanzamiento en npm y registro MCP

• CLAUDE.md — estructura del repositorio para agentes de IA

Licencia

MIT