Repolode
benborla

benborla/mcp-server-mysql

Servidor MCP que da a LLM como Claude acceso de solo lectura a bases de datos MySQL, con operaciones de escritura opcionales que se habilitan mediante flags.

Estrellas
2,175
Forks
260
Issues abiertos
51
Último commit
hace 3 meses

¿Qué es?

Este proyecto implementa el Model Context Protocol (MCP) para MySQL y permite que un cliente LLM, como Claude Code o Claude Desktop, inspeccione esquemas de bases de datos y ejecute consultas SQL en un servidor MySQL. Está diseñado para que el modelo explore los datos sin modificarlos: el modo de solo lectura está activado de forma predeterminada, y cada operación de inserción, actualización y eliminación debe habilitarse mediante variables de entorno.

Además de las consultas básicas, incorpora varias medidas de seguridad y funcionalidades prácticas. Admite túneles SSH para conectarse a bases de datos remotas, un modo multidatabase para consultar varias bases de datos sin volver a conectarse y permisos de lectura y escritura por base de datos. La redacción automática de PII oculta los valores sensibles en los resultados y admite conexiones SSL/TLS con una configuración mTLS opcional. El modo remoto expone el servidor a través de HTTP con autenticación mediante bearer token.

El servidor se instala mediante npx y se configura con variables de entorno MYSQL_*. Requiere Node.js 20 o posterior y MySQL 5.7 o posterior; se recomienda MySQL 8.0.

Funciones clave

  • 01Solo lectura de forma predeterminada; las operaciones de inserción, actualización y eliminación se habilitan mediante flags independientes.
  • 02Inspección de esquemas y ejecución de consultas SQL expuestas como herramientas y recursos MCP.
  • 03Compatibilidad con túneles SSH para bases de datos remotas.
  • 04Modo multidatabase para consultar varias bases de datos sin volver a conectarse.
  • 05Redacción automática de PII para ocultar valores sensibles en los resultados de las consultas.
  • 06Conexiones SSL/TLS con mTLS opcional y modo remoto HTTP con autenticación mediante bearer token.

Casos de uso

  • Permitir que Claude Code o Claude Desktop explore un esquema MySQL y responda preguntas sobre los datos.
  • Dar a un asistente de IA acceso analítico seguro y de solo lectura a datos similares a los de producción.
  • Consultar una instancia MySQL remota mediante un túnel SSH desde un cliente de IA local.
  • Realizar análisis en varias bases de datos desde una sola sesión de LLM.

Inicio rápido

  1. 1

    Necesita Node.js v20 o superior y un usuario de MySQL con los privilegios adecuados

  2. 2

    Registra el servidor en Claude Code y configura las variables de entorno de conexión a MySQL

    claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql

Antes de usarlo

  • Necesita Node.js v20 o superior y una base de datos MySQL 5.7 o superior (se recomienda 8.0 o superior).
  • Las operaciones de escritura están desactivadas de forma predeterminada y deben activarse con variables de entorno independientes.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mcp-server-mysql?
Servidor MCP que da a LLM como Claude acceso de solo lectura a bases de datos MySQL, con operaciones de escritura opcionales que se habilitan mediante flags. Este proyecto implementa el Model Context Protocol (MCP) para MySQL y permite que un cliente LLM, como Claude Code o Claude Desktop, inspeccione esquemas de bases de datos y ejecute consultas SQL en un servidor MySQL. Está diseñado para que el modelo explore los datos sin modificarlos: el modo de solo lectura está activado de forma predeterminada, y cada operación de inserción, actualización y eliminación debe habilitarse mediante variables de entorno.
¿mcp-server-mysql es gratuito? ¿Qué licencia tiene?
mcp-server-mysql es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-server-mysql sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de mcp-server-mysql fue el 27 jul 2026.
¿Para qué puedo usar mcp-server-mysql?
Permitir que Claude Code o Claude Desktop explore un esquema MySQL y responda preguntas sobre los datos. Dar a un asistente de IA acceso analítico seguro y de solo lectura a datos similares a los de producción. Consultar una instancia MySQL remota mediante un túnel SSH desde un cliente de IA local. Realizar análisis en varias bases de datos desde una sola sesión de LLM.
¿Cómo se instala mcp-server-mysql?
Necesita Node.js v20 o superior y un usuario de MySQL con los privilegios adecuados Registra el servidor en Claude Code y configura las variables de entorno de conexión a MySQL: claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql
¿Dónde consigo mcp-server-mysql?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/benborla/mcp-server-mysql

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados