MySQL MCP Server

Integra-se com bancos de dados MySQL para fornecer acesso seguro a bancos de dados para LLMs

Documentação

MySQL MCP Server

Uma implementação de servidor MCP que integra com bancos de dados MySQL, fornecendo capacidades seguras de acesso a banco de dados para LLMs.

Recursos

  • Operações de Leitura
    • Executar consultas SELECT somente leitura
    • Listar todas as tabelas do banco de dados
    • Mostrar estruturas de tabelas
    • Visualizar informações de esquema
  • Operações de Escrita
    • Executar INSERT/UPDATE/DELETE com suporte a transações
    • Consultas parametrizadas para segurança dos dados
    • Retorna linhas afetadas e IDs de inserção
  • Segurança
    • Modo de transação somente leitura para consultas SELECT
    • Limites de tamanho de consulta e de resultados
    • Monitoramento de desempenho e registro de logs
    • Tratamento automático de transações

Instalação

npm install -g @kevinwatt/mysql-mcp

Uso com Dive Desktop

  1. Clique em "+ Add MCP Server" no Dive Desktop
  2. Copie e cole esta configuração:
{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mysql-mcp"
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "your_database"
      }
    }
  }
}
  1. Clique em "Save" para instalar o servidor MCP

Documentação das Ferramentas

  • mysql_query

    • Executa consultas SELECT somente leitura
    • Entradas:
      • sql (string): consulta SQL SELECT a executar
    • Limites:
      • Tamanho máximo da consulta: 4096 caracteres
      • Número máximo de linhas no resultado: 1000
      • Tempo limite da consulta: 30 segundos
  • mysql_execute

    • Executa operações de modificação de dados
    • Entradas:
      • sql (string): declaração SQL (INSERT/UPDATE/DELETE)
      • params (array, opcional): parâmetros para a declaração SQL
    • Recursos:
      • Retorna a contagem de linhas afetadas
      • Retorna o último ID de inserção
      • Tratamento automático de transações
  • list_tables

    • Lista todas as tabelas no banco de dados atual
    • Nenhuma entrada necessária
  • describe_table

    • Mostra a estrutura da tabela
    • Entradas:
      • table (string): nome da tabela a descrever

Exemplos de Uso

Peça ao seu LLM para:

"Show me all tables in the database"
"Describe the structure of users table"
"Select all active users from the database"
"Insert a new record into orders table"

Inicialização Manual

Se necessário, inicie o servidor manualmente:

npx @kevinwatt/mysql-mcp

Requisitos

  • Node.js 18+
  • MySQL Server
  • Serviço LLM compatível com MCP

Licença

MIT

Autor

Dewei Yen

Palavras-chave

  • mcp
  • mysql
  • database
  • dive
  • llm
  • ai