Servidor MySQL MCP
El servidor de protocolo de contexto de modelo (MCP) MySQL es una herramienta que le permite conectarse a una base de datos MySQL local y permitir que los modelos de lenguaje grandes (LLM) ejecuten consultas SQL en ella.
Requisitos
Node.js : 20.0.0 o posterior
MySQL : servidor MySQL o MariaDB versión 5.7 o posterior
Related MCP server: YugabyteDB MCP Server
función
Ejecutar consultas MySQL : Ejecute consultas SQL directamente desde LLM
Obtención de información de la base de datos : lista de bases de datos, lista de tablas, confirmación de la estructura de la tabla
Compatible con MCP : admite el protocolo de contexto de modelo y se puede integrar con LLM
Comunicación stdio : comuníquese con LLM mediante entrada/salida estándar, sin vinculación de puertos
Guardar información de conexión : guarde la información de conexión de la base de datos localmente y reutilícela
Instalación y uso
Ejecución temporal en NPX
opción
opción | explicación | Valor predeterminado |
| Host MySQL | host local |
| Puerto MySQL | 13306 |
| Usuario de MySQL | raíz |
| Contraseña de MySQL | (cadena vacía) |
| Base de datos predeterminada | (opción) |
| Ruta del archivo de configuración | (opción) |
| Conectarse automáticamente a la base de datos al iniciar el servidor | FALSO |
| Puerto del servidor MCP (no se utiliza en modo stdio) | 3000 |
| Host del servidor MCP (no se utiliza en modo stdio) | host local |
| Tiempo de espera de consulta (ms) | 30000 |
| Máximo de filas de resultados | 1000 |
| Modo de depuración | FALSO |
Guardar y reutilizar la información de conexión
El servidor MySQL MCP almacena localmente información sobre las bases de datos a las que se ha conectado exitosamente. Esto permite que la información de conexión se reutilice automáticamente en el próximo lanzamiento. La información de conexión guardada se almacena en .mysql-mcp-connections.json en el directorio de inicio del usuario.
La información de conexión incluye:
Nombre de host
Número de puerto
Nombre de usuario
contraseña
Nombre de la base de datos (si está configurado)
Uso de archivos de configuración
También puede configurar la información de conexión mediante un archivo de configuración (en formato JSON):
Si utiliza un archivo de configuración:
Método de comunicación
El servidor MySQL MCP opera en modo "stdio" de acuerdo con el MCP (Protocolo de contexto de modelo). Esto le permite comunicarse a través de entrada y salida estándar en lugar de vincularse a un puerto específico. Esto tiene las siguientes ventajas:
Evitar conflictos de puertos : no se utilizan puertos específicos, por lo que no se producen problemas de conflicto de puertos.
Seguridad mejorada : no se utiliza comunicación de red, lo que reduce el riesgo de ataques a nivel de red.
Comunicación simple entre procesos : comunicación simplificada con LLM
Puntos importantes a tener en cuenta
En el modo stdio, los mensajes se envían en formato JSON.
Debes enviar un mensaje JSON por línea
La información de error y los registros de conexión se envían al error estándar (stderr).
Herramientas MCP proporcionadas
Gestión de la conexión a bases de datos
Nombre de la herramienta | explicación | Parámetros requeridos |
conectar_base_de_datos | Conectarse a la base de datos | host, puerto, usuario |
desconectar_base_de_datos | Desconecta la conexión de base de datos actual | ninguno |
obtener_estado_de_conexión | Obtiene el estado de la conexión a la base de datos. | ninguno |
Operaciones de consulta SQL
Nombre de la herramienta | explicación | Parámetros requeridos |
ejecutar_consulta | Ejecutar una consulta MySQL | consulta: sentencia SQL |
obtener_bases_de_datos | Obtenga una lista de bases de datos disponibles | ninguno |
obtener_tablas | Obtiene una lista de tablas en una base de datos especificada. | base de datos (opcional) |
describe_tabla | Obtiene la estructura de la tabla especificada. | mesa |
Función de gestión de conexión
MySQL MCP Server le permite separar el inicio del servidor y las conexiones de la base de datos. Este enfoque ofrece los siguientes beneficios:
Iniciar sin información de conexión : el servidor se puede iniciar sin información de conexión a la base de datos.
Conexiones de bases de datos múltiples : puede cambiar las conexiones a diferentes bases de datos después de que se inicie el servidor.
Instalación sencilla : simplemente ejecute
npx -y https://github.com/yuki777/mysql-mcp-server
Cómo utilizar la gestión de conexiones
Iniciar el servidor sin conexión automática :
npx -y https://github.com/yuki777/mysql-mcp-serverConéctese a la base de datos utilizando la herramienta de conexión :
{ "type": "tool_call", "request_id": "req_1", "tool": "connect_database", "arguments": { "host": "localhost", "port": 3306, "user": "root", "password": "your_password", "database": "your_db" } }Comprueba el estado de tu conexión :
{ "type": "tool_call", "request_id": "req_2", "tool": "get_connection_status", "arguments": {} }Pérdida de conexión :
{ "type": "tool_call", "request_id": "req_3", "tool": "disconnect_database", "arguments": {} }
Guión de prueba
El repositorio incluye un script de prueba llamado test-connection-management.js . Puede utilizar este script para probar la funcionalidad de gestión de conexión:
Información para desarrolladores
Configuración de su entorno de desarrollo
Construir
licencia
ISC
contribución
Se aceptan informes de errores, solicitudes de funciones y solicitudes de extracción.