MySQL-MCP

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

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

MCP MySQL Server
Atomzzm
-
security
-
license
-
quality
A Model Context Protocol server that enables AI models to interact with MySQL databases, providing tools for querying, executing statements, listing tables, and describing table structures.
Last updated -
MIT License
Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP MySQL Server
kevinbin
-
security
-
license
-
quality
A Model Context Protocol server that enables AI models to interact with MySQL databases through a standardized interface, providing tools for querying, executing commands, and managing database schemas.
Last updated -
JavaScript
MSSQL MCP Server
knight0zh
-
security
A
license
-
quality
A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
Last updated -
3
TypeScript
MIT License

View all related MCP servers