Aplicación MySQL de MCP

Una implementación de servidor de herramientas de Protocolo de Contexto de Modelo (MCP) para interactuar con bases de datos MySQL a través de interfaces de IA.

Descripción general

Este proyecto proporciona un conjunto de herramientas que permiten a los sistemas de IA conectarse a bases de datos MySQL y consultarlas mediante el Protocolo de Contexto de Modelo. Permite a los asistentes de IA ejecutar consultas SQL y comprobar la conectividad de la base de datos.

Características

Integración de herramientas MySQL sencilla pero potente
Definiciones de herramientas de tipo seguro
Manejo mejorado de errores
Soporte para el manejo de señales de cancelación de solicitudes
Conciencia de la sesión

Instalación

Clonar este repositorio
Instalar dependencias:

npm install

Cómo utilizar la herramienta

1. Configuración inicial

Clonar este repositorio:

git clone <repository-url>
cd mcp-mysql-app

Instalar dependencias:

npm install

Cree un archivo .env en el directorio raíz:

MYSQL_HOST=your_mysql_host
MYSQL_USER=your_mysql_username
MYSQL_PASSWORD=your_mysql_password
MYSQL_DATABASE=your_database_name
MYSQL_PORT=3306

Construir el proyecto:

npm run build

La carpeta dist ahora está lista para usarse para la configuración en varias plataformas de IA.

2. Configuración del cursor

Encuentre su archivo de configuración de Cursor MCP:

Windows: C:\Users\<username>\.cursor\mcp.json
macOS: ~/.cursor/mcp.json
Linux: ~/.cursor/mcp.json

Edite el archivo para agregar la configuración del servidor MySQL MCP:

{
  "mcpServers": {
    "mysql": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "your_mysql_host",
        "MYSQL_USER": "your_mysql_username",
        "MYSQL_PASSWORD": "your_mysql_password",
        "MYSQL_DATABASE": "your_database_name",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

Reemplace los marcadores de posición:

<path-to-node> : Ruta a su ejecutable Node.js
<path-to-project> : Ruta absoluta al directorio del proyecto de su aplicación MySQL de MCP
Variables de entorno MySQL con los detalles de conexión de su base de datos real

Ejemplo de configuración:

{
  "mcpServers": {
    "mysql": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "H:\\mcp\\my-mysql\\dist\\index.js"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password123",
        "MYSQL_DATABASE": "todo_app",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

Guarde el archivo y reinicie Cursor para que los cambios surtan efecto.

3. Configuración de Claude

Para usar MCP MySQL Tools con Claude, debe agregar la configuración al archivo de configuración de Claude. Siga estos pasos:

Abra la configuración de la aplicación de escritorio Claude AI
Vaya a la sección "Desarrollador"
Busque la sección de configuración "Herramientas"
Agregue la configuración para MySQL MCP de la siguiente manera:

{
  "tools": {
    "mysql": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "your_mysql_host",
        "MYSQL_USER": "your_mysql_username",
        "MYSQL_PASSWORD": "your_mysql_password",
        "MYSQL_DATABASE": "your_database_name",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

Reemplace los marcadores de posición:

<path-to-node> : Ruta a su ejecutable Node.js
<path-to-project> : Ruta absoluta al directorio del proyecto de su aplicación MySQL de MCP
Variables de entorno MySQL con los detalles de conexión de su base de datos real

Ejemplo de configuración:

{
  "tools": {
    "mysql": {
      "command": "/usr/local/bin/node",
      "args": [
        "/Users/username/projects/mcp-mysql-app/dist/index.js"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password123",
        "MYSQL_DATABASE": "todo_app",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

4. Configuración en otras plataformas

El principio básico es el mismo para otras plataformas de IA que admiten MCP:

Encuentre el área de configuración para herramientas externas o MCP
Configúrelo para ejecutar Node.js con el archivo dist/index.js de este repositorio
Incluya los detalles de su conexión MySQL en la configuración del entorno

Herramientas disponibles

Después de la configuración, su IA tendrá acceso a las siguientes herramientas MySQL:

sql_check_connection - Comprueba si la conexión MySQL está funcionando
sql_query - Ejecutar consultas SQL en la base de datos conectada

Uso de herramientas MySQL en entornos de IA

Una vez configuradas las herramientas MySQL en tu entorno de IA, puedes empezar a usarlas solicitando ayuda a la IA. Aquí tienes algunos ejemplos:

Uso de herramientas MySQL en Cursor

En Cursor, puedes simplemente pedirle a Claude que realice tareas relacionadas con MySQL:

Compruebe si la conexión MySQL está funcionando.
Muéstrame todas las bases de datos en el servidor.
Obtener todas las tablas de la base de datos actual.
Ejecute una consulta para recuperar todos los usuarios de la tabla de usuarios.
Actualizar un registro en la tabla de productos.

Ejemplo de flujo de trabajo: consulta y manipulación de datos

A continuación se muestra un ejemplo de flujo de trabajo que muestra cómo puede utilizar estas herramientas:

Comprobando la conexión:"Comprueba si la conexión MySQL funciona".Claude utilizará la herramienta sql_check_connection para verificar la conexión a la base de datos.
Visualización de bases de datos:"Muéstrame todas las bases de datos en este servidor MySQL".Claude utilizará la herramienta sql_query con SHOW DATABASES; .
Explorando tablas:"Enumerar todas las tablas de la base de datos actual."Claude utilizará la herramienta sql_query con SHOW TABLES; .
Consulta de datos:"Muéstrame los primeros 10 registros de la tabla de usuarios".Claude utilizará la herramienta sql_query con SELECT * FROM users LIMIT 10; .
Creando tablas:"Cree una nueva tabla llamada 'productos' con columnas para id, nombre, precio y descripción".Claude utilizará la herramienta sql_query para crear la tabla con una declaración CREATE TABLE adecuada.
Insertar datos:"Insertar un nuevo producto con el nombre 'Smartphone', precio 499,99 y descripción 'Último modelo'."Claude utilizará la herramienta sql_query con una declaración INSERT.
Actualización de registros:"Actualizar el precio del producto 'Smartphone' a 449,99."Claude utilizará la herramienta sql_query con una declaración UPDATE.

Estos ejemplos demuestran con qué naturalidad puedes interactuar con MySQL a través de tu asistente de IA una vez que las herramientas estén configuradas correctamente.

Soporte y ayuda

Si tiene problemas al utilizar esta herramienta, por favor:

Comprueba que los datos de tu conexión MySQL sean correctos
Asegúrese de que Node.js esté instalado correctamente
Verifique la configuración de su MCP en su plataforma de IA
Revise los archivos de registro para ver si aparecen mensajes de error
Verifique la conectividad de red con su servidor MySQL

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

MCP MySQL App

Integrations