MySQL MCP Server

Proporciona acceso de solo lectura a bases de datos MySQL, permitiendo que los LLMs inspeccionen esquemas y ejecuten consultas.

Documentación

@davewind/mysql-mcp-server

Trust Score

Un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona acceso de solo lectura a bases de datos MySQL. Este servidor permite a los LLM inspeccionar esquemas de bases de datos y ejecutar consultas de solo lectura.

Características Clave

  1. Acceso de Solo Lectura a la Base de Datos: Aplica operaciones de solo lectura mediante validación SQL y transacciones de SOLO LECTURA
  2. Descubrimiento de Esquemas: Identifica y expone automáticamente las estructuras de las tablas de la base de datos
  3. Ejecución de Consultas SQL: Proporciona una herramienta de consulta que acepta y ejecuta sentencias SELECT
  4. Cumplimiento del Protocolo de Contexto de Modelos: Implementa la especificación MCP para una integración fluida con LLMs compatibles
  5. Configuración Simple: Configuración fácil con requisitos mínimos

Herramientas

  • query
    • Ejecuta consultas SQL de solo lectura contra la base de datos conectada
    • Entrada: sql (cadena): La consulta SQL a ejecutar
    • Todas las consultas se ejecutan dentro de una transacción de SOLO LECTURA

Recursos

El servidor proporciona información de esquema para cada tabla en la base de datos:

  • Esquemas de Tablas (mysql://user:password@localhost:3306/database)
    • Información de esquema JSON para cada tabla
    • Incluye nombres de columnas y tipos de datos
    • Descubiertos automáticamente a partir de los metadatos de la base de datos

Instalación

npm install @davewind/mysql-mcp-server -g

Configuración

Archivo de configuración de ajustes de MCP:

uso recomendado

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@davewind/mysql-mcp-server", "mysql://user:password@localhost:port/database"],
    }
  }
}

Prueba

Reemplaza mysql://usuario:contraseña@localhost:puerto/ y ejecuta npm run inspector

  "scripts": {
    "inspector": "npx @modelcontextprotocol/inspector@0.10.2 build/index.js mysql://user:password@localhost:port/database
  }

Entorno


node v18 +

Arquitectura del Sistema

El servidor MySQL MCP actúa como intermediario entre los LLMs y las bases de datos MySQL, procesando solicitudes según el Protocolo de Contexto de Modelos.

Interacción de Componentes

Interacción de Componentes

Modelo de Seguridad

El servidor MySQL MCP implementa un modelo de seguridad estricto para garantizar que el acceso a la base de datos sea de solo lectura.

Las medidas de seguridad incluyen:

  1. Validación de consultas SQL para permitir únicamente sentencias SELECT
  2. Ejecución de todas las consultas dentro de transacciones de SOLO LECTURA
  3. Sin soporte para operaciones de modificación de datos (INSERT, UPDATE, DELETE, etc.)
  4. Sin soporte para modificación del esquema de la base de datos (CREATE, ALTER, DROP, etc.)

Integración con LLMs

El servidor MySQL MCP está diseñado para funcionar con cualquier sistema LLM que soporte el Protocolo de Contexto de Modelos. Se comunica a través de JSON-RPC sobre stdio, siguiendo la especificación MCP.

Licencia

MIT