local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables secure connections to local MySQL databases, supporting all types of SQL queries (SELECT, INSERT, UPDATE, DELETE, etc.) through natural language interaction

Servidor SQL MCP para Claude Desktop

Una interfaz de lenguaje natural para sus bases de datos MySQL locales a través de Claude Desktop. Este servidor MCP (Protocolo de Comunicación de Máquina) permite a Claude ejecutar consultas SQL en sus bases de datos MySQL locales, lo que le permite interactuar con ellas mediante lenguaje natural.

Características

Conversión de consultas de lenguaje natural a SQL a través de Claude
Conexión segura a bases de datos MySQL locales
Soporte para múltiples bases de datos
Gestión de transacciones para la consistencia de los datos
Agrupación de conexiones para un mejor rendimiento
Soporte para todo tipo de consultas SQL (SELECT, INSERT, UPDATE, DELETE, etc.)

Prerrequisitos

Python 3.8 o superior
Servidor MySQL instalado y en funcionamiento
Aplicación de escritorio Claude
Entorno virtual (recomendado)

Instalación

Clonar este repositorio:

git clone git@github.com:meanands/mysql-mcp.git
cd mysql-mcp

Crear y activar un entorno virtual:

# For macOS/Linux
python -m venv venv
source venv/bin/activate

# For Windows
python -m venv venv
venv\Scripts\activate

Instalar dependencias:

pip install -r requirements.txt

Cree un archivo .env en la raíz del proyecto con sus credenciales MySQL:

MYSQL_HOST=localhost
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password

Actualice la ruta del directorio en run.sh :

# Open run.sh and replace this line:
cd /Users/yourname/code/sql-mcp
# with your actual project directory path, for example:
cd /Users/yourname/projects/mysql-mcp

Hacer que el script de ejecución sea ejecutable:

chmod +x run.sh

Configuración en Claude Desktop

Abra la configuración MCP de Claude Desktop
Agregue la siguiente configuración:

{
  "sql": {
    "command": "/absolute/path/to/your/mysql-mcp/run.sh"
  }
}

Reemplace /absolute/path/to/your/mysql-mcp con la ruta absoluta real al directorio de su proyecto.

Uso

Una vez configurado, podrá interactuar con sus bases de datos a través de Claude Desktop usando lenguaje natural. Ejemplos:

Seleccionar una base de datos y crear una tabla:

Use the 'employees' database and create a table for storing employee information with fields for name, email, and department.

Insertar datos:

Insert a new employee named John Doe with email john.doe@example.com in the Engineering department.

Consulta de datos:

Show me all employees in the Engineering department.

Notas importantes

Utilice siempre rutas absolutas en el script run.sh y en la configuración de Claude Desktop
Asegúrese de que el servidor MySQL esté en ejecución antes de usar el servidor MCP
Mantenga su archivo .env seguro y nunca lo envíe al control de versiones
El servidor MCP utiliza agrupación de conexiones con un tamaño de grupo predeterminado de 5 conexiones

Solución de problemas

Si recibe un error de "conexión rechazada", asegúrese de que su servidor MySQL esté en ejecución
Si recibe un error de autenticación, verifique sus credenciales en el archivo .env
Para errores de permisos, asegúrese de que su usuario MySQL tenga los privilegios adecuados para las operaciones que intenta realizar

Consideraciones de seguridad

Almacene credenciales confidenciales en el archivo .env
Utilice un usuario MySQL con los permisos adecuados (evite utilizar root)
Mantenga su entorno virtual y sus dependencias actualizados
Tenga en cuenta la seguridad de la red si accede a servidores MySQL que no son locales

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Una interfaz de lenguaje natural que permite a Claude ejecutar consultas SQL en sus bases de datos MySQL locales, lo que permite la interacción de la base de datos mediante lenguaje natural.

Related Resources

Reddit Discussion about this server

SQL MCP Server for Claude Desktop