MySQL MCP Server

MySQL MCP Server

Un servidor de Model Context Protocol que proporciona acceso de solo lectura a bases de datos MySQL. Este servidor permite a los LLM inspeccionar esquemas de bases de datos y ejecutar consultas de solo lectura.

Autenticación

El servidor admite la autenticación de MySQL a través de la URL de la base de datos. El formato de la URL es:

mysql://username:password@host:port/database

Ejemplos:

• DB: mysql://user:pass@localhost:3306/mydb

Nota: Asegúrate siempre de que tus credenciales estén debidamente protegidas y no queden expuestas en configuraciones públicas.

Componentes

Herramientas

• query
  • Ejecuta consultas SQL de solo lectura contra la base de datos conectada
  • Entrada: sql (string): La consulta SQL a ejecutar
  • Todas las consultas se ejecutan dentro de una transacción READ ONLY
  • La autenticación se gestiona automáticamente con las credenciales proporcionadas

Recursos

El servidor proporciona información de esquema para cada tabla de la base de datos:

• Table Schemas (mysql://<host>/<table>/schema)
  • Información de esquema JSON para cada tabla
  • Incluye nombres de columnas y tipos de datos
  • Se descubre automáticamente a partir de los metadatos de la base de datos
  • El acceso se autentica con las credenciales proporcionadas

Instalación

1. Clona el repositorio:

git clone https://github.com/yourusername/mysql-mcp-server.git
cd mysql-mcp-server

2. Prepara e instala las dependencias:

npm run prepare
npm install

3. Crea un enlace global:

npm link

Ahora puedes usar el comando mysql-mcp-server desde cualquier lugar de tu terminal:

mysql-mcp-server mysql://user:password@localhost:3306/mydb

Uso con Cursor

Configuración de MCP en Cursor

1. Abre la configuración de Cursor:

   • Haz clic en el icono de engranaje (⚙️) en la esquina inferior izquierda de Cursor
   • O presiona Shift + Cmd + J en macOS

2. Configura el servidor MCP:

   • Haz clic en "MCP" en la barra lateral izquierda
   • Haz clic en "Add Global MCP Server"
   • Añade la siguiente configuración:

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://user:password@localhost:3306/mydb"]
    }
  }
}

3. Guarda la configuración:
   • Haz clic en "Save" o presiona Cmd + S
   • Reinicia Cursor para que los cambios surtan efecto

¿Cómo usarlo en Cursor?

Abre el chat Agentic en Cursor y empieza a hacer preguntas relacionadas con nuestra base de datos y tendrá todo el contexto

Buenas prácticas de seguridad

1. Usa variables de entorno para las credenciales sensibles:

   {
     "mcpServers": {
       "mysql": {
         "command": "mysql-mcp-server",
         "args": ["mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@host:3306/mydb"]
       }
     }
   }
   

2. Asegúrate de que el usuario de MySQL tenga los permisos mínimos necesarios (acceso READ-ONLY)

3. Usa contraseñas seguras y sigue las buenas prácticas de seguridad

4. Evita enviar a control de versiones archivos de configuración con credenciales

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.