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

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

 npx -y https://github.com/yuki777/mysql-mcp-server --host 127.0.0.1 --port 13306 --user root

opción

opción	explicación	Valor predeterminado
`-h, --host <host>`	Host MySQL	host local
`-p, --port <port>`	Puerto MySQL	13306
`-u, --user <user>`	Usuario de MySQL	raíz
`--password <password>`	Contraseña de MySQL	(cadena vacía)
`-d, --database <database>`	Base de datos predeterminada	(opción)
`-c, --config <path>`	Ruta del archivo de configuración	(opción)
`--auto-connect`	Conectarse automáticamente a la base de datos al iniciar el servidor	FALSO
`--server-port <port>`	Puerto del servidor MCP (no se utiliza en modo stdio)	3000
`--server-host <host>`	Host del servidor MCP (no se utiliza en modo stdio)	host local
`--query-timeout <ms>`	Tiempo de espera de consulta (ms)	30000
`--max-results <count>`	Máximo de filas de resultados	1000
`--debug`	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):

{
  "server": {
    "port": 3000,
    "host": "localhost"
  },
  "mysql": {
    "host": "localhost",
    "port": 13306,
    "user": "root",
    "password": "yourpassword",
    "database": "mydb"
  },
  "debug": false,
  "queryTimeout": 30000,
  "maxResultSize": 1000
}

Si utiliza un archivo de configuración:

npx -y https://github.com/yuki777/mysql-mcp-server -c ./mysql-mcp-config.json

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-server
Coné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:

node test-connection-management.js

Información para desarrolladores

Configuración de su entorno de desarrollo

# リポジトリのクローン
git clone [repository-url]
cd mysql-mcp-server

# 依存関係のインストール
npm install

# 開発モードでの実行
npm run dev

Construir

npm run build

licencia

ISC

contribución

Se aceptan informes de errores, solicitudes de funciones y solicitudes de extracción.

MySQL MCP Server

Integrations