Servidor MCP para MySQL

Este es un servidor MCP (Model Context Protocol) que proporciona acceso a la base de datos MySQL local rangernomina.

Características

• Ejecutar consultas SQL personalizadas
• Listar todas las tablas de la base de datos
• Describir la estructura de las tablas
• Obtener datos de las tablas con límites configurables
• Conexión segura usando variables de entorno

Instalación

1. Navegar al directorio del proyecto:

cd tools/mysql-mcp

2. Instalar las dependencias:

pip install -r requirements.txt

3. Configurar las variables de entorno en el archivo .env (ya está configurado):

MYSQL_HOST=localhost
MYSQL_DATABASE=rangernomina
MYSQL_USER=root
MYSQL_PASSWORD=RHoss.1234
MYSQL_PORT=3306

Herramientas Disponibles

1. execute_sql

Ejecuta consultas SQL personalizadas.

• Parámetros:
  • query (requerido): La consulta SQL a ejecutar
  • params (opcional): Parámetros para la consulta

2. list_tables

Lista todas las tablas de la base de datos.

• Parámetros: Ninguno

3. describe_table

Describe la estructura de una tabla específica.

• Parámetros:
  • table_name (requerido): Nombre de la tabla a describir

4. get_table_data

Obtiene datos de una tabla con límite configurable.

• Parámetros:
  • table_name (requerido): Nombre de la tabla
  • limit (opcional): Límite de registros (por defecto 100)

Uso

El servidor se ejecuta como un proceso que lee solicitudes JSON desde stdin y devuelve respuestas JSON a stdout, siguiendo el protocolo MCP.

python server.py

Configuración MCP

Para usar este servidor con Cline, agrega la siguiente configuración a tu archivo de configuración MCP:

{
  "mcpServers": {
    "mysql-local": {
      "command": "python",
      "args": ["D:/ssd/Projects/tools/mysql-mcp/server.py"],
      "cwd": "D:/ssd/Projects/tools/mysql-mcp"
    }
  }
}