@enemyrr/mcp-servidor-mysql

Un servidor de Protocolo de Contexto de Modelo que proporciona operaciones con bases de datos MySQL. Este servidor permite que los modelos de IA interactúen con bases de datos MySQL mediante una interfaz estandarizada.

Instalación y configuración de Cursor IDE

Instalación mediante herrería

Para instalar MySQL Database Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @enemyrr/mcp-mysql-server --client claude

Instalación manual

Clonar y construir el proyecto:

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

Agregue el servidor en la configuración de Cursor IDE:
- Abrir la paleta de comandos (Cmd/Ctrl + Shift + P)
- Buscar "MCP: Agregar servidor"
- Rellene los campos:
  - Nombre: mysql
  - Tipo: command
  - Comando: node /absolute/path/to/mcp-mysql-server/build/index.js

Nota : Reemplace /absolute/path/to/ con la ruta real donde clonó y construyó el proyecto.

Configuración de la base de datos

Puede configurar la conexión a la base de datos de tres maneras:

URL de la base de datos en .env (recomendado):

DATABASE_URL=mysql://user:password@host:3306/database

Parámetros individuales en .env :

DB_HOST=localhost
DB_USER=your_user
DB_PASSWORD=your_password
DB_DATABASE=your_database

Conexión directa mediante herramienta :

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://user:password@host:3306/database"
    // OR
    workspace: "/path/to/your/project" // Will use project's .env
    // OR
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

Herramientas disponibles

1. connect_db

Conéctese a la base de datos MySQL mediante URL, ruta del espacio de trabajo o credenciales directas.

2. consulta

Ejecutar consultas SELECT con parámetros de declaración preparada opcionales.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. ejecutar

Ejecute consultas INSERT, UPDATE o DELETE con parámetros de declaración preparada opcionales.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "john@example.com"]
  }
});

4. listas_de_tablas

Enumere todas las tablas en la base de datos conectada.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables"
});

5. describe_tabla

Obtener la estructura de una tabla específica.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"
  }
});

6. crear_tabla

Crea una nueva tabla con campos e índices específicos.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "create_table",
  arguments: {
    table: "users",
    fields: [
      {
        name: "id",
        type: "int",
        autoIncrement: true,
        primary: true
      },
      {
        name: "email",
        type: "varchar",
        length: 255,
        nullable: false
      }
    ],
    indexes: [
      {
        name: "email_idx",
        columns: ["email"],
        unique: true
      }
    ]
  }
});

7. agregar_columna

Agregar una nueva columna a una tabla existente.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "add_column",
  arguments: {
    table: "users",
    field: {
      name: "phone",
      type: "varchar",
      length: 20,
      nullable: true
    }
  }
});

Características

Múltiples métodos de conexión (URL, espacio de trabajo, directo)
Manejo seguro de conexiones con limpieza automática
Soporte de declaraciones preparadas para parámetros de consulta
Herramientas de gestión de esquemas
Manejo integral de errores y validación
Compatibilidad con TypeScript
Detección automática del espacio de trabajo

Seguridad

Utiliza sentencias preparadas para evitar la inyección de SQL
Admite el manejo seguro de contraseñas a través de variables de entorno
Valida las consultas antes de su ejecución
Cierra automáticamente las conexiones cuando termina

Manejo de errores

El servidor proporciona mensajes de error detallados para:

Fallos de conexión
Consultas o parámetros no válidos
Configuración faltante
Errores de base de datos
Errores de validación del esquema

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios a https://github.com/enemyrr/mcp-mysql-server

Licencia

Instituto Tecnológico de Massachusetts (MIT)