MySQL MCP Server

Servidor MCP MySQL

Um servidor Model Context Protocol que fornece acesso somente leitura a bancos de dados MySQL. Este servidor permite que LLMs inspecionem esquemas de banco de dados e executem consultas somente leitura.

Autenticação

O servidor suporta autenticação MySQL através da URL do banco de dados. O formato da URL é:

mysql://username:password@host:port/database

Exemplos:

• DB: mysql://user:pass@localhost:3306/mydb

Nota: Sempre garanta que suas credenciais estejam devidamente protegidas e não expostas em configurações públicas.

Componentes

Ferramentas

• query
  • Executa consultas SQL somente leitura no banco de dados conectado
  • Entrada: sql (string): A consulta SQL a ser executada
  • Todas as consultas são executadas dentro de uma transação SOMENTE LEITURA
  • A autenticação é tratada automaticamente usando as credenciais fornecidas

Recursos

O servidor fornece informações de esquema para cada tabela no banco de dados:

• Esquemas de Tabela (mysql://<host>/<table>/schema)
  • Informações de esquema JSON para cada tabela
  • Inclui nomes de colunas e tipos de dados
  • Descobertos automaticamente a partir dos metadados do banco de dados
  • O acesso é autenticado usando as credenciais fornecidas

Instalação

1. Clone o repositório:

git clone https://github.com/yourusername/mysql-mcp-server.git
cd mysql-mcp-server

2. Prepare e instale as dependências:

npm run prepare
npm install

3. Crie um link global:

npm link

Agora você pode usar o comando mysql-mcp-server de qualquer lugar no seu terminal:

mysql-mcp-server mysql://user:password@localhost:3306/mydb

Uso com Cursor

Configurando MCP no Cursor

1. Abra as configurações do Cursor:

   • Clique no ícone de engrenagem (⚙️) no canto inferior esquerdo do Cursor
   • Ou pressione Shift + Cmd + J no macOS

2. Configure o Servidor MCP:

   • Clique em "MCP" na barra lateral esquerda
   • Clique em "Adicionar Servidor MCP Global"
   • Adicione a seguinte configuração:

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://user:password@localhost:3306/mydb"]
    }
  }
}

3. Salve a configuração:
   • Clique em "Salvar" ou pressione Cmd + S
   • Reinicie o Cursor para que as alterações tenham efeito

Como usar no Cursor?

Abra o chat Agentic no Cursor e comece a fazer perguntas relacionadas ao nosso banco de dados e ele terá todo o contexto

Boas Práticas de Segurança

1. Use variáveis de ambiente para credenciais sensíveis:

   {
     "mcpServers": {
       "mysql": {
         "command": "mysql-mcp-server",
         "args": ["mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@host:3306/mydb"]
       }
     }
   }
   

2. Garanta que o usuário MySQL tenha as permissões mínimas necessárias (acesso SOMENTE LEITURA)

3. Use senhas fortes e siga as boas práticas de segurança

4. Evite commitar arquivos de configuração com credenciais no controle de versão

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.