MySQL MCP Server

MySQL MCP Server

Un potente servidor MCP que proporciona acceso directo a bases de datos MySQL. Este servidor permite a los agentes de IA interactuar con bases de datos MySQL, ejecutar consultas SQL y gestionar el contenido de la base de datos a través de una interfaz sencilla.

Características

Recursos

• Accede a notas almacenadas en la base de datos mediante note:///{id} URIs
• Cada nota tiene un título y contenido
• Tipo MIME de texto plano para acceso simple al contenido

Herramientas

• create_note - Crea nuevas notas de texto en la base de datos
  • Toma título y contenido como parámetros requeridos
  • Almacena la nota en la base de datos MySQL
• list_tables - Lista todas las tablas en la base de datos conectada
• count_tables - Obtén el número total de tablas en la base de datos
• search_tables - Busca tablas usando el patrón LIKE
• describe_table - Obtén la estructura de una tabla específica
• execute_sql - Ejecuta consultas SQL personalizadas

Requisitos previos

• Node.js 18 o superior
• Servidor MySQL instalado y en ejecución
• Una base de datos con permisos apropiados

Configuración

1. Clona este repositorio:

   git clone git@github.com:LeonMelamud/mysql-mcp.git
   cd mysql-mcp
   

2. Instala las dependencias:

   npm install
   

3. Crea un archivo .env en el directorio raíz con los detalles de tu conexión MySQL:

   MYSQL_HOST=localhost
   MYSQL_USER=your_username
   MYSQL_PASSWORD=your_password
   MYSQL_DATABASE=your_database
   

4. Compila el servidor:

   npm run build
   

Instalación

Para Claude Desktop

Añade la configuración del servidor a tu archivo de configuración de Claude Desktop:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Para Cline

Añade la configuración del servidor a tu archivo de configuración de MCP de Cline:

En MacOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json En Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ejemplos de uso

Una vez instalado, puedes usar el servidor MySQL MCP en tus conversaciones con Claude:

Lista todas las tablas en la base de datos

Please list all the tables in my MySQL database.

Ejecuta una consulta SQL

Run this SQL query: SELECT * FROM users LIMIT 5

Crea una nota

Create a note titled "Meeting Notes" with the content "Discussed project timeline and assigned tasks."

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Usa el Inspector MCP para depurar el servidor:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.

Licencia

MIT