❤
npm
Sign UpSign In

mysql-mcp-server-carlo

1.2.0 • Public • Published

MySQL MCP Server

Un servidor MCP (Model Context Protocol) para bases de datos MySQL con opciones de configuración flexibles.

English | Español

Español

Novedades en la versión 1.2.0

  • Soporte para conexión global (sin base de datos fija al inicio)
  • Nuevos comandos MCP:
    • list_databases: Lista todas las bases de datos disponibles
    • create_database: Crea una nueva base de datos
    • use_database: Cambia la base de datos activa en la sesión
  • Ahora el password puede ser vacío (soporta root sin contraseña)
  • Mejoras de seguridad y flexibilidad

Descripción

Este es un servidor MCP que permite conectar y consultar bases de datos MySQL desde cualquier cliente compatible con el protocolo MCP (como Claude Desktop, VS Code con Copilot, etc.). Ofrece configuración flexible mediante argumentos de línea de comandos, variables de entorno o archivos .env.

Características

  • 🔍 Ejecución de consultas - Ejecuta cualquier consulta SQL personalizada
  • 📋 Listado de tablas - Lista todas las tablas de la base de datos
  • 🏗️ Estructura de tablas - Describe esquemas y estructuras de tablas
  • 🌐 Configuración flexible - Variables de entorno, archivos .env o argumentos de línea de comandos
  • 🗂️ Listado de bases de datos - Lista todas las bases de datos disponibles
  • 🆕 Crear base de datos - Permite crear nuevas bases de datos
  • 🔄 Cambiar base de datos activa - Cambia la base de datos sobre la que se opera

Instalación

Opción 1: NPX (Recomendada)

npx mysql-mcp-server-carlo --host localhost --port 3306 --user miusuario --password mipassword --database mibd

Opción 2: Instalación Global

npm install -g mysql-mcp-server-carlo
mysql-mcp-server-carlo --host localhost --port 3306 --user miusuario --password mipassword --database mibd

Configuración

Argumentos de Línea de Comandos (Recomendado para distribución)

mysql-mcp-server-carlo --host HOST --port PUERTO --user USUARIO --password PASSWORD --database BASE_DE_DATOS

Variables de Entorno

export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=miusuario
export MYSQL_PASSWORD=mipassword
export MYSQL_DATABASE=mibd
mysql-mcp-server-carlo

Archivo .env (Solo para desarrollo)

Crear un archivo .env:

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=miusuario
MYSQL_PASSWORD=mipassword
MYSQL_DATABASE=mibd

Configuración MCP

Claude Desktop

Agregar a tu archivo claude_desktop_config.json:

{
	"mcpServers": {
		"mysql": {
			"command": "npx",
			"args": [
				"mysql-mcp-server-carlo",
				"--host",
				"localhost",
				"--port",
				"3306",
				"--user",
				"tu_usuario",
				"--password",
				"tu_password",
				"--database",
				"tu_base_de_datos"
			]
		}
	}
}

VS Code con Copilot

Agregar a tu configuración MCP:

{
	"mcpServers": {
		"mysql-mcp": {
			"command": "npx",
			"args": [
				"mysql-mcp-server-carlo",
				"--host",
				"localhost",
				"--port",
				"3306",
				"--user",
				"carlos",
				"--password",
				"1234",
				"--database",
				"test"
			]
		}
	}
}

Otros Clientes MCP

Usar configuración similar con el comando y argumentos.

Módulos Disponibles

🔍 query - Ejecución de Consultas SQL

Propósito: Ejecutar cualquier consulta SQL personalizada (SELECT, INSERT, UPDATE, DELETE, administración de usuarios, etc.) Parámetros:

  • sql (string): La consulta SQL a ejecutar
  • params (array, opcional): Parámetros para consultas preparadas

Ejemplo de uso:

SELECT * FROM productos WHERE precio > 100
INSERT INTO productos (nombre, precio, stock) VALUES ('Nuevo Producto', 99.99, 50)

📋 list_tables - Listado de Tablas

Propósito: Obtener una lista de todas las tablas disponibles en la base de datos Parámetros: Ninguno Uso: Ideal para explorar la estructura de la base de datos y conocer qué tablas están disponibles

🏗️ describe_table - Estructura de Tablas

Propósito: Obtener información detallada sobre la estructura de una tabla específica Parámetros:

  • table_name (string): Nombre de la tabla a describir

Información que proporciona:

  • Nombres de columnas
  • Tipos de datos
  • Claves primarias y foráneas
  • Valores por defecto
  • Restricciones NULL/NOT NULL

🗂️ list_databases - Listado de Bases de Datos

Propósito: Obtener una lista de todas las bases de datos disponibles en el servidor Parámetros: Ninguno Uso: Útil para conocer qué bases de datos están disponibles en el servidor

🆕 create_database - Crear Base de Datos

Propósito: Crear una nueva base de datos Parámetros:

  • database_name (string): Nombre de la base de datos a crear

Ejemplo de uso:

CREATE DATABASE nueva_bd

🔄 use_database - Cambiar Base de Datos Activa

Propósito: Cambiar la base de datos activa para la sesión Parámetros:

  • database_name (string): Nombre de la base de datos a usar

Ejemplo de uso:

USE_BASE_DE_DATOS mibd

Seguridad

  • ✅ Validación de entrada para nombres de tablas
  • ✅ Consultas preparadas para prevenir inyección SQL
  • ✅ Sanitización de parámetros
  • ✅ Sin vulnerabilidades de inyección SQL

Licencia

MIT

English

Description

This is an MCP server that allows connecting and querying MySQL databases from any MCP-compatible client (like Claude Desktop, VS Code with Copilot, etc.). It offers flexible configuration through command-line arguments, environment variables, or .env files.

Features

  • 🔍 Query execution - Run any custom SQL query
  • 📋 Table listing - List all database tables
  • 🏗️ Table structure - Describe table schemas and structures
  • 🌐 Flexible configuration - Environment variables, .env files, or command-line arguments
  • 🗂️ Database listing - List all available databases
  • 🆕 Create database - Allows creating new databases
  • 🔄 Switch active database - Changes the database on which operations are performed

Installation

Option 1: NPX (Recommended)

npx mysql-mcp-server-carlo --host localhost --port 3306 --user myuser --password mypass --database mydb

Option 2: Global Installation

npm install -g mysql-mcp-server-carlo
mysql-mcp-server-carlo --host localhost --port 3306 --user myuser --password mypass --database mydb

Configuration

Command Line Arguments (Recommended for distribution)

mysql-mcp-server-carlo --host HOST --port PORT --user USER --password PASSWORD --database DATABASE

Environment Variables

export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=myuser
export MYSQL_PASSWORD=mypass
export MYSQL_DATABASE=mydb
mysql-mcp-server-carlo

Available Modules

🔍 query - SQL Query Execution

Purpose: Execute any custom SQL query (SELECT, INSERT, UPDATE, DELETE) Parameters:

  • sql (string): The SQL query to execute
  • params (array, optional): Parameters for prepared statements

📋 list_tables - Table Listing

Purpose: Get a list of all available tables in the database Parameters: None Usage: Ideal for exploring database structure

🏗️ describe_table - Table Structure

Purpose: Get detailed information about a specific table structure Parameters:

  • table_name (string): Name of the table to describe

🗂️ list_databases - Database Listing

Purpose: Get a list of all available databases on the server Parameters: None Usage: Useful for knowing what databases are available on the server

🆕 create_database - Create Database

Purpose: Create a new database Parameters:

  • database_name (string): Name of the database to create

Example:

CREATE DATABASE new_db

🔄 use_database - Switch Active Database

Purpose: Change the active database for the session Parameters:

  • database_name (string): Name of the database to use

Example:

USE_DATABASE mydb

Security

  • ✅ Input validation for table names
  • ✅ Prepared statements to prevent SQL injection
  • ✅ Parameter sanitization
  • ✅ No SQL injection vulnerabilities

License

MIT

/mysql-mcp-server-carlo/

    Package Sidebar

    Install

    npm i mysql-mcp-server-carlo

    Repository

    github.com/CarlosMS12/mysql-mcp-server

    Homepage

    github.com/CarlosMS12/mysql-mcp-server#readme

    Weekly Downloads

    78

    Version

    1.2.0

    License

    MIT

    Unpacked Size

    23.5 kB

    Total Files

    4

    Last publish

    Collaborators

    • carlosms12
    Try on RunKit
    Report malware