mysqldb-mcp-server

by burakdirin
Verified

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.

Integrations

  • Provides tools to connect to MySQL databases and execute SQL queries, with support for multiple queries, returning results in JSON format. Configurable for different MySQL environments and includes optional read-only mode.

Servidor MCP mysqldb-mcp-server

Un proyecto de servidor MCP de 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/consultas 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 (predeterminado: "localhost")
  • MYSQL_USER : nombre de usuario de MySQL (predeterminado: "root")
  • MYSQL_PASSWORD : Contraseña de MySQL (predeterminada: "")
  • MYSQL_DATABASE : Base de datos inicial (opcional)
  • MYSQL_READONLY : modo de solo lectura (establecido en 1/verdadero para habilitar, valor predeterminado: falso)

Inicio rápido

Instalación

Escritorio de Claude

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

Ventanas: %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 herrería

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

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

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar archivo de bloqueo:
uv sync
  1. Distribuciones de paquetes de compilación:
uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:
uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores 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 en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor MCP que permite la integración de bases de datos MySQL con Claude. Permite ejecutar consultas SQL y administrar conexiones a bases de datos.

  1. Installation
    1. Components
      1. Tools
    2. Configuration
      1. Quickstart
        1. Installation
        2. Installing via Smithery
      2. Development
        1. Building and Publishing
        2. Debugging
      ID: qgvfelf3i1