local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses environment variables for configuration, allowing database credentials to be securely stored and accessed through a .env file.
Hosts the repository for the MCP server, enabling users to clone and install the server from GitHub.
Provides database interaction capabilities through MySQL, enabling SQL query execution, table management, schema analysis, and business intelligence generation with automatic insights creation.

zaj-MySQL-MCP

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona interacción con bases de datos y capacidades de inteligencia empresarial a través de MySQL. Este servidor permite ejecutar consultas SQL, analizar datos empresariales y generar automáticamente memorandos de información empresarial.

Características

Ejecutar consultas SQL contra una base de datos MySQL
Crear y administrar tablas de bases de datos
Analizar el esquema de la base de datos
Generar y almacenar información empresarial
Acceda a un memorando de información empresarial actualizado continuamente

Herramientas

Herramientas de consulta

read_query : Ejecuta consultas SELECT para leer datos de la base de datos
- Entrada: query (cadena) - La consulta SQL SELECT a ejecutar
- Devuelve: Resultados de la consulta como una matriz de objetos
write_query : Ejecuta consultas INSERT, UPDATE o DELETE
- Entrada: query (cadena) - La consulta de modificación de SQL
- Devoluciones: { affected_rows: number }
create_table : Crea nuevas tablas en la base de datos
- Entrada: query (cadena) - instrucción SQL CREATE TABLE
- Devuelve: Confirmación de creación de la tabla

Herramientas de esquema

list_tables : Obtener una lista de todas las tablas en la base de datos
- No se requiere entrada
- Devuelve: Matriz de nombres de tablas
describe_table : Ver información del esquema para una tabla específica
- Entrada: table_name (cadena) - Nombre de la tabla a describir
- Devuelve: Matriz de definiciones de columnas con nombres y tipos

Herramientas de análisis

append_insight : agrega nuevos conocimientos comerciales al recurso de memorando
- Entrada: insight (cadena): información empresarial obtenida a partir del análisis de datos
- Devoluciones: Confirmación de la adición de información
- Activa la actualización del recurso memo://insights

Recursos

El servidor expone un único recurso:

memo://insights : un memorando de información empresarial que se actualiza continuamente y que recopila información descubierta durante el análisis.
- Se actualiza automáticamente a medida que se descubren nuevos conocimientos a través de la herramienta de anexar conocimientos.

Detalles de implementación

Este servidor MCP implementa el Protocolo de Contexto de Modelo directamente, sin depender de dependencias externas del SDK. Utiliza:

mysql2 : Para la conectividad de bases de datos MySQL
yargs : para el análisis de argumentos de la línea de comandos
readline : para gestionar la comunicación stdin/stdout

El servidor sigue el protocolo JSON-RPC 2.0 para comunicarse con Claude, manejando solicitudes de listados de herramientas, listados de recursos y ejecución de herramientas.

Configuración

El servidor MySQL MCP utiliza variables de entorno para la configuración. Cree un archivo .env en el directorio raíz con las siguientes variables:

# Database Connection
DB_CONNECTION=mysql

# Database Host
DB_HOST=localhost

# Database Port
DB_PORT=3306

# Database Username (required)
DB_USER=your_mysql_username

# Database Password (required)
DB_PASSWORD=your_mysql_password

# Database Name (required)
DB_NAME=your_database_name

Se proporciona un archivo .env.example como plantilla. Cópielo en .env y actualice los valores:

cp .env.example .env
# Then edit .env with your database credentials

Uso con Claude Desktop

Agregue el servidor a su cline_mcp_settings.json :

"mcpServers": {
  "mysql": {
    "command": "node",
    "args": [
      "/path/to/zaj_MySQL_MCP/build/index.js"
    ],
    "disabled": false,
    "autoApprove": []
  }
}

Tenga en cuenta que las credenciales de la base de datos ahora se configuran a través del archivo .env , no a través de argumentos de la línea de comando.

Construyendo y funcionando

Clonar el repositorio:

git clone https://github.com/zajTools/zaj-MySQL-MCP.git
cd zaj-MySQL-MCP

Crea y configura tu archivo .env:

cp .env.example .env
# Edit .env with your database credentials

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Ejecutar el servidor:

node build/index.js

Demostración y ejemplos

Hemos incluido materiales de ejemplo para ayudarlo a comenzar a utilizar el servidor MySQL MCP:

Base de datos de muestra : un esquema de base de datos de comercio electrónico completo con clientes, productos, pedidos y datos de ventas
Consultas de ejemplo : consultas preescritas que demuestran varias capacidades del servidor MCP
Escenarios de uso : ejemplos de cómo Claude puede interactuar con su base de datos MySQL

Para probar la demostración:

Consulte la Guía de demostración para obtener instrucciones paso a paso.
Ejecute el script SQL de configuración para crear la base de datos de muestra
Configurar el servidor MCP para conectarse a la base de datos de demostración
¡Empieza a hacerle preguntas a Claude sobre tus datos!

Estos ejemplos están diseñados para mostrar el potencial de usar Claude con bases de datos MySQL, pero el servidor MCP funciona con cualquier base de datos MySQL a la que tenga acceso.

Licencia

Este servidor MCP tiene licencia MIT.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite la ejecución de consultas SQL, la gestión de bases de datos y las capacidades de inteligencia empresarial a través de conexiones MySQL.

Related Resources

Reddit Discussion about this server