MySQL DB

Servidor MCP mysqldb-mcp-server

Um projeto de servidor MCP para banco de dados MySQL.

Instalação

Você pode instalar o pacote usando uv:

uv pip install mysqldb-mcp-server

Ou usando pip:

pip install mysqldb-mcp-server

Componentes

Ferramentas

O servidor fornece duas ferramentas:

• connect_database: Conecta a um banco de dados MySQL específico

  • Parâmetro database: Nome do banco de dados para conectar (string)
  • Retorna uma mensagem de confirmação quando a conexão é bem-sucedida

• execute_query: Executa consultas MySQL

  • Parâmetro query: Consulta(s) SQL para executar (string)
  • Retorna resultados da consulta em formato JSON
  • Múltiplas consultas podem ser enviadas separadas por ponto e vírgula

Configuração

O servidor usa as seguintes variáveis de ambiente:

• MYSQL_HOST: Endereço do servidor MySQL (padrão: "localhost")
• MYSQL_USER: Nome de usuário do MySQL (padrão: "root")
• MYSQL_PASSWORD: Senha do MySQL (padrão: "")
• MYSQL_DATABASE: Banco de dados inicial (opcional)
• MYSQL_READONLY: Modo somente leitura (defina como 1/true para ativar, padrão: false)

Início rápido

Instalação

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"
      }
    }
  }
}

Instalando via Smithery

Para instalar o Servidor de Integração de Banco de Dados MySQL para Claude Desktop automaticamente via Smithery:

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

Desenvolvimento

Construindo e Publicando

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Construa as distribuições do pacote:

uv build

Isso criará distribuições de origem e wheel no diretório dist/.

3. Publique no PyPI:

uv publish

Nota: Você precisará definir as credenciais do PyPI via variáveis de ambiente ou flags de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP executam via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

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

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.