# 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:
```bash
cd tools/mysql-mcp
```

2. Instalar las dependencias:
```bash
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.

```bash
python server.py
```

## Configuración MCP

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

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