Servidor MySQL MCP

Pruebas PyPI - Descargas

Servidor MySQL MCP

Una implementación del Protocolo de Contexto de Modelo (MCP) que permite la interacción segura con bases de datos MySQL. Este componente de servidor facilita la comunicación entre las aplicaciones de IA (hosts/clientes) y las bases de datos MySQL, lo que permite una exploración y un análisis más seguros y estructurados mediante una interfaz controlada.

Nota : MySQL MCP Server no está diseñado para usarse como un servidor independiente, sino como una implementación de protocolo de comunicación entre aplicaciones de IA y bases de datos MySQL.

Características

Listar las tablas MySQL disponibles como recursos
Leer el contenido de la tabla
Ejecutar consultas SQL con manejo de errores adecuado
Acceso seguro a la base de datos mediante variables de entorno
Registro completo

Instalación

Instalación manual

pip install mysql-mcp-server

Instalación mediante herrería

Para instalar MySQL MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install mysql-mcp-server --client claude

Configuración

Establezca las siguientes variables de entorno:

MYSQL_HOST=localhost     # Database host
MYSQL_PORT=3306         # Optional: Database port (defaults to 3306 if not specified)
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

Uso

Con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Con Visual Studio Code

Añade esto a tu mcp.json :

{
  "servers": {
      "mysql": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "--from",
                "mysql-mcp-server",
                "mysql_mcp_server"
            ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
  }
}

Nota: Será necesario instalar uv para que esto funcione.

Depuración con MCP Inspector

Si bien MySQL MCP Server no está diseñado para ejecutarse de forma independiente o directamente desde la línea de comandos con Python, puedes usar el Inspector MCP para depurarlo.

El inspector MCP proporciona una forma conveniente de probar y depurar su implementación de MCP:

# Install dependencies
pip install -r requirements.txt
# Use the MCP Inspector for debugging (do not run directly with Python)

El servidor MySQL MCP está diseñado para integrarse con aplicaciones de inteligencia artificial como Claude Desktop y no debe ejecutarse directamente como un programa Python independiente.

Desarrollo

# Clone the repository
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest

Consideraciones de seguridad

Nunca confirme variables de entorno ni credenciales
Utilice un usuario de base de datos con los permisos mínimos requeridos
Considere implementar la lista blanca de consultas para uso en producción
Supervisar y registrar todas las operaciones de la base de datos

Mejores prácticas de seguridad

Esta implementación de MCP requiere acceso a la base de datos para funcionar. Por seguridad:

Cree un usuario MySQL dedicado con permisos mínimos
Nunca utilice credenciales root o cuentas administrativas
Restringir el acceso a la base de datos únicamente a las operaciones necesarias
Habilitar el registro para fines de auditoría
Revisiones de seguridad periódicas del acceso a las bases de datos

Consulte la Guía de configuración de seguridad de MySQL para obtener instrucciones detalladas sobre:

Creación de un usuario MySQL restringido
Establecer permisos apropiados
Monitoreo del acceso a la base de datos
Mejores prácticas de seguridad

⚠️ IMPORTANTE: Siga siempre el principio del mínimo privilegio al configurar el acceso a la base de datos.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

execute_sql

Permite a los asistentes de IA enumerar tablas, leer datos y ejecutar consultas SQL a través de una interfaz controlada, lo que hace que la exploración y el análisis de bases de datos sean más seguros y estructurados.

Related MCP Servers

MCP-MySQL Server
enemyrr
A
security
F
license
A
quality
Enables AI models to perform MySQL database operations through a standardized interface, supporting secure connections, query execution, and comprehensive schema management.
Last updated -
7
35
22
JavaScript
Metabase MCP Server
imlewc
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.
Last updated -
25
JavaScript
MySQL MCP
Liu-creators
-
security
F
license
-
quality
A tool that provides simple API to execute SQL queries and manage MySQL databases, designed to integrate with Cursor IDE for AI assistants to directly perform database operations.
Last updated -
Python
MySQL MCP Server
amornpan
-
security
F
license
-
quality
Enables secure interaction with MySQL databases, allowing AI assistants to list tables, read data, and execute SQL queries through a controlled interface.
Last updated -
Python

View all related MCP servers

MySQL MCP Server