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.)

Related MCP server: MySQL MCP Server

Prerrequisitos

• Python 3.8 o superior

• Servidor MySQL instalado y en funcionamiento

• Aplicación de escritorio Claude

• Entorno virtual (recomendado)

Instalación

1. Clonar este repositorio:

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

2. 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

3. Instalar dependencias:

pip install -r requirements.txt

4. 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

5. 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

6. Hacer que el script de ejecución sea ejecutable:

chmod +x run.sh

Configuración en Claude Desktop

1. Abra la configuración MCP de Claude Desktop

2. 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:

1. 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.

2. Insertar datos:

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

3. 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

1. Si recibe un error de "conexión rechazada", asegúrese de que su servidor MySQL esté en ejecución

2. Si recibe un error de autenticación, verifique sus credenciales en el archivo .env

3. 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