MySQL

Servidor MCP para MySQL

Patrocinador — Bloome

¿Usando mcp-server-mysql para que tu IA consulte MySQL? Bloome lleva eso a todo tu equipo: una plataforma de mensajería instantánea con agentes de IA donde los agentes de IA son miembros del chat. Conecta tus herramientas MCP y haz que los agentes inspeccionen esquemas, ejecuten consultas y respondan preguntas de datos para todos en un solo hilo. Cero configuración local, se ejecuta en la nube, en web y móvil.

---

Servidor MCP que da a Claude y otros LLMs acceso a MySQL: inspecciona esquemas, ejecuta consultas y opcionalmente escribe datos, todo a través del Model Context Protocol.

Características principales

• Solo lectura por defecto — las operaciones de escritura se activan mediante variables de entorno
• Integración con Claude Code — optimizado para la CLI de Claude Code de Anthropic
• Soporte de túnel SSH — soporte integrado para bases de datos remotas
• Modo multi-base de datos — consulta a través de múltiples bases de datos sin reconexión
• Permisos específicos por esquema — control de lectura/escritura por base de datos
• Redacción de PII — enmascaramiento automático de datos sensibles en los resultados
• Modo remoto — transporte HTTP con autenticación con token Bearer
• Soporte SSL/TLS — conexiones cifradas con opción mTLS

Requisitos

• Node.js v20+
• MySQL 5.7+ (se recomienda 8.0+)
• Usuario de MySQL con privilegios apropiados

Instalación rápida

Claude Code (lo más simple):

claude mcp add mcp_server_mysql \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="your_password" \
  -e MYSQL_DB="your_database" \
  -- npx @benborla29/mcp-server-mysql

Claude Desktop / otros clientes:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

Todas las operaciones de escritura están deshabilitadas por defecto. Actívalas con ALLOW_INSERT_OPERATION=true, ALLOW_UPDATE_OPERATION=true, ALLOW_DELETE_OPERATION=true.

Documentación

• Guía de instalación — Smithery, Cursor, Codex, Claude Code, repositorio local, modo remoto
• Configuración y variables de entorno — todas las variables de entorno, configuración avanzada
• Modo multi-base de datos — consulta de múltiples bases de datos
• Redacción de PII — enmascaramiento automático de datos
• Pruebas — configuración y ejecución de pruebas
• Solución de problemas — problemas comunes y soluciones
• Registro de cambios

Herramientas y recursos

Herramienta: mysql_query Ejecuta consultas SQL. Solo lectura por defecto. Operaciones de escritura habilitadas según la bandera.

Recursos: mysql://tables Lista todas las tablas y metadatos de columnas para la base de datos conectada.

Contribuciones

Se aceptan PRs en github.com/benborla/mcp-server-mysql.

git clone https://github.com/benborla/mcp-server-mysql.git
pnpm install
pnpm run build
pnpm test

Licencia

MIT — consulta LICENSE para más detalles.