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

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:

2. Crear y activar un entorno virtual:

3. Instalar dependencias:

4. Cree un archivo .env en la raíz del proyecto con sus credenciales MySQL:

5. Actualice la ruta del directorio en run.sh :

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

Configuración en Claude Desktop

1. Abra la configuración MCP de Claude Desktop

2. Agregue la siguiente configuración:

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:

2. Insertar datos:

3. Consulta de datos:

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