Repolode
designcomputer

designcomputer/mysql_mcp_server

Un servidor MCP que permite a asistentes de IA como Claude explorar y consultar bases de datos MySQL mediante un conjunto controlado de herramientas.

Estrellas
1,408
Forks
260
Issues abiertos
4
Último commit
hace 10 días

¿Qué es?

MySQL MCP Server implementa el Model Context Protocol para que las aplicaciones de IA puedan conectarse a una base de datos MySQL y trabajar con su esquema y sus datos. En lugar de dar al modelo acceso irrestricto a la base de datos, ofrece un conjunto fijo de herramientas: ejecutar consultas SQL, inspeccionar esquemas de tablas y tomar muestras de filas de una tabla.

Funciona mediante stdio para clientes locales como Claude Desktop, Claude Code y VS Code, o mediante Streamable HTTP (SSE) para despliegues remotos. La configuración de conexión se obtiene de variables de entorno e incluye modos SSL/TLS, túneles SSH para acceder a bases de datos privadas y un modo multibase de datos que funciona con todas las bases de datos de usuario del servidor cuando no se especifica una en particular. Las contraseñas y las claves SSH se enmascaran en los registros.

El servidor también ofrece dos prompts guiados, explore_database y analyze_table, que combinan las herramientas de esquema y muestreo en flujos de trabajo de varios pasos. El transporte SSE no incluye autenticación integrada, por lo que el proyecto recomienda situarlo detrás de un proxy inverso si se expone fuera de localhost.

Funciones clave

  • 01Enumera las tablas MySQL como recursos y permite leer su contenido
  • 02Ejecuta consultas SQL, incluidas instrucciones SELECT, SHOW, DESCRIBE y DML
  • 03Devuelve detalles del esquema, como tipos de columna, si admiten valores nulos, valores predeterminados y comentarios
  • 04Toma muestras de hasta 20 filas de una tabla
  • 05Admite transportes stdio y SSE/HTTP
  • 06Ofrece túneles SSH, modos SSL/TLS y un modo multibase de datos

Casos de uso

  • Permitir que Claude u otro asistente de IA responda preguntas sobre el contenido de una base de datos
  • Explorar el esquema de una base de datos desconocida antes de escribir consultas
  • Dar a una herramienta de IA acceso de solo lectura o de escritura limitada a una instancia MySQL de desarrollo o staging
  • Acceder a un servidor MySQL privado mediante un host bastión SSH

Inicio rápido

  1. 1

    Instala el paquete desde PyPI

    pip install mysql-mcp-server
  2. 2

    Configura MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD y MYSQL_DATABASE en el bloque env de la configuración del cliente MCP

  3. 3

    Registra el servidor con Claude Code CLI

    claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server

Antes de usarlo

  • Solo se admiten sentencias SQL individuales; se rechazan las consultas con varias sentencias.
  • El transporte SSE no incluye autenticación integrada y requiere un proxy inverso si se expone fuera de localhost.
  • Los hosts como Claude Desktop no cargan el archivo .env del proyecto, por lo que las credenciales deben incluirse en la configuración de MCP.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mysql_mcp_server?
Un servidor MCP que permite a asistentes de IA como Claude explorar y consultar bases de datos MySQL mediante un conjunto controlado de herramientas. MySQL MCP Server implementa el Model Context Protocol para que las aplicaciones de IA puedan conectarse a una base de datos MySQL y trabajar con su esquema y sus datos. En lugar de dar al modelo acceso irrestricto a la base de datos, ofrece un conjunto fijo de herramientas: ejecutar consultas SQL, inspeccionar esquemas de tablas y tomar muestras de filas de una tabla.
¿mysql_mcp_server es gratuito? ¿Qué licencia tiene?
mysql_mcp_server es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mysql_mcp_server sigue mantenido?
Mantenimiento activo. El último commit de mysql_mcp_server fue el 28 oct 2026.
¿Para qué puedo usar mysql_mcp_server?
Permitir que Claude u otro asistente de IA responda preguntas sobre el contenido de una base de datos Explorar el esquema de una base de datos desconocida antes de escribir consultas Dar a una herramienta de IA acceso de solo lectura o de escritura limitada a una instancia MySQL de desarrollo o staging Acceder a un servidor MySQL privado mediante un host bastión SSH
¿Cómo se instala mysql_mcp_server?
Instala el paquete desde PyPI: pip install mysql-mcp-server Configura MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD y MYSQL_DATABASE en el bloque env de la configuración del cliente MCP Registra el servidor con Claude Code CLI: claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server
¿Dónde consigo mysql_mcp_server?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/designcomputer/mysql_mcp_server

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

Proyectos relacionados