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

Related MCP server: MCP MySQL Server

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

1. Clonar el repositorio:

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

2. Crea y configura tu archivo .env:

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

3. Instalar dependencias:

npm install

4. Construir el servidor:

npm run build

5. 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:

1. Consulte la Guía de demostración para obtener instrucciones paso a paso.

2. Ejecute el script SQL de configuración para crear la base de datos de muestra

3. Configurar el servidor MCP para conectarse a la base de datos de demostración

4. ¡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.