mcp-mysql
3.1
If you are the rightful owner of mcp-mysql and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MCP MySQL Server is a protocol server designed for MySQL connections using SSH tunneling.
MCP MySQL Server
Servidor MCP para conexión MySQL con túnel SSH.
Requisitos Previos
- Node.js (versión 14 o superior)
- Acceso SSH al servidor remoto
- Cliente MySQL
- Cursor IDE
Instalación
- Clona este repositorio:
git clone [URL_DEL_REPOSITORIO]
cd [NOMBRE_DEL_DIRECTORIO]
- Crea el archivo de configuración:
cp mcp-config.env.example mcp-config.env
- Configura las variables en
mcp-config.env:
Variables de Configuración MySQL
# Configuración de conexión MySQL
MYSQL_HOST=127.0.0.1 # Host de MySQL (por defecto localhost)
MYSQL_PORT=3306 # Puerto de MySQL (por defecto 3306)
MYSQL_USER= # Tu usuario de MySQL
MYSQL_PASS= # Tu contraseña de MySQL
MYSQL_DB= # Nombre de la base de datos
# Permisos de operaciones
ALLOW_INSERT_OPERATION=false # Permitir operaciones INSERT
ALLOW_UPDATE_OPERATION=false # Permitir operaciones UPDATE
ALLOW_DELETE_OPERATION=false # Permitir operaciones DELETE
ALLOW_SELECT_OPERATION=true # Permitir operaciones SELECT (consultas)
# Configuración SSH para túnel
SSH_HOST= # Hostname del servidor SSH
SSH_USER= # Usuario SSH
SSH_PORT_MAPPING=3306:127.0.0.1:3306 # Mapeo de puertos para el túnel SSH
- Instala las dependencias:
npm install
Configuración en Cursor IDE
- Localiza o crea el archivo
mcp.jsonen la rutaC:\Users\[TU_USUARIO]\.cursor\mcp.json - Añade la siguiente configuración (ajusta la ruta a la ubicación donde clonaste el repositorio):
{
"mcpServers": {
"MySQL": {
"transportType": "stdio",
"command": "npm",
"args": ["--silent", "--prefix", "RUTA_A_TU_PROYECTO", "run", "start-mcp"]
}
}
}
Por ejemplo, si clonaste el proyecto en C:\proyectos\mcp-mysql, la configuración sería:
{
"mcpServers": {
"MySQL": {
"transportType": "stdio",
"command": "npm",
"args": ["--silent", "--prefix", "C:\\proyectos\\mcp-mysql", "run", "start-mcp"]
}
}
}
Uso
Para iniciar el servidor:
npm run start-mcp
Estructura del Proyecto
start-mcp.js: Script principal que inicia el túnel SSH y el servidor MCPmcp-config.env: Archivo de configuración (no incluido en el repositorio)package.json: Definición de dependencias y scripts
Notas Importantes
- No modifiques las versiones de las dependencias en package.json para mantener la compatibilidad
- Asegúrate de tener acceso SSH configurado correctamente
- No compartas tu archivo mcp-config.env
- Por defecto, solo las operaciones SELECT están habilitadas. Modifica los permisos según tus necesidades
- El túnel SSH es necesario para conexiones a bases de datos remotas. Si estás usando una base de datos local, puedes dejar la configuración SSH vacía
