Servidor MySQL MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la interacción segura con bases de datos MySQL. Este servidor permite a los asistentes de IA listar tablas, leer datos y ejecutar consultas SQL a través de una interfaz controlada, lo que hace que la exploración y el análisis de bases de datos sean más seguros y estructurados.

Características

Listar las tablas MySQL disponibles como recursos
Leer el contenido de la tabla
Ejecutar consultas SQL con manejo de errores adecuado
Acceso seguro a la base de datos mediante variables de entorno
Registro completo

Configuración

Establezca las siguientes variables de entorno:

MYSQL_HOST=localhost     # Database host
MYSQL_PORT=3306         # Optional: Database port (defaults to 3306 if not specified)
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

Uso

Con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "mysql": {
      "command": "python",
      "args": [
        "-m", 
        "src.mysql_mcp_server.server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Como servidor independiente

# Clone the repository
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# Install dependencies
pip install -r requirements.txt

# Run the server
python -m src.mysql_mcp_server.server

Desarrollo

# Clone the repository
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server

# Create virtual environment
python -m venv py-mcp-mysql_venv
source py-mcp-mysql_venv/bin/activate  # or `py-mcp-mysql_venv\Scripts\activate` on Windows

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

Consideraciones de seguridad

Nunca confirme variables de entorno ni credenciales
Utilice un usuario de base de datos con los permisos mínimos requeridos
Considere implementar la lista blanca de consultas para uso en producción
Supervisar y registrar todas las operaciones de la base de datos

Mejores prácticas de seguridad

Este servidor MCP requiere acceso a la base de datos para funcionar. Por seguridad:

Cree un usuario MySQL dedicado con permisos mínimos
Nunca utilice credenciales root o cuentas administrativas
Restringir el acceso a la base de datos únicamente a las operaciones necesarias
Habilitar el registro para fines de auditoría
Revisiones de seguridad periódicas del acceso a las bases de datos

Consulte la Guía de configuración de seguridad de MySQL para obtener instrucciones detalladas sobre:

Creación de un usuario MySQL restringido
Establecer permisos apropiados
Monitoreo del acceso a la base de datos
Mejores prácticas de seguridad

⚠️ IMPORTANTE: Siga siempre el principio del mínimo privilegio al configurar el acceso a la base de datos.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

MySQL MCP Server

Integrations