MySQL DB

mysqldb-mcp-server MCP server

Un proyecto de servidor MCP para base de datos MySQL.

Instalación

Puedes instalar el paquete usando uv:

uv pip install mysqldb-mcp-server

O usando pip:

pip install mysqldb-mcp-server

Componentes

Herramientas

El servidor proporciona dos herramientas:

• connect_database: Se conecta a una base de datos MySQL específica

  • Parámetro database: Nombre de la base de datos a la que conectarse (cadena)
  • Devuelve un mensaje de confirmación cuando la conexión es exitosa

• execute_query: Ejecuta consultas MySQL

  • Parámetro query: Consulta(s) SQL a ejecutar (cadena)
  • Devuelve los resultados de la consulta en formato JSON
  • Se pueden enviar múltiples consultas separadas por punto y coma

Configuración

El servidor utiliza las siguientes variables de entorno:

• MYSQL_HOST: Dirección del servidor MySQL (por defecto: "localhost")
• MYSQL_USER: Nombre de usuario de MySQL (por defecto: "root")
• MYSQL_PASSWORD: Contraseña de MySQL (por defecto: "")
• MYSQL_DATABASE: Base de datos inicial (opcional)
• MYSQL_READONLY: Modo de solo lectura (establecer a 1/true para habilitar, por defecto: false)

Inicio rápido

Instalación

Claude Desktop

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/burakdirin/Projects/mysqldb-mcp-server",
        "run",
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[optional]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "mysqldb-mcp-server": {
      "command": "uvx",
      "args": [
        "mysqldb-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "[optional]",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

Instalación mediante Smithery

Para instalar MySQL Database Integration Server para Claude Desktop automáticamente mediante Smithery:

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

Desarrollo

Compilación y publicación

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Compilar las distribuciones del paquete:

uv build

Esto creará distribuciones de fuente y wheel en el directorio dist/.

3. Publicar en PyPI:

uv publish

Nota: Necesitarás establecer las credenciales de PyPI mediante variables de entorno o banderas de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el MCP Inspector.

Puedes lanzar el MCP Inspector mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/mysqldb-mcp-server run mysqldb-mcp-server

Al lanzarlo, el Inspector mostrará una URL que puedes acceder en tu navegador para comenzar la depuración.