MySQL Server

mysql-server MCP Server

Um servidor Model Context Protocol para acesso a banco de dados MySQL

Este é um servidor MCP baseado em TypeScript que fornece ferramentas para consultar bancos de dados MySQL. Ele demonstra conceitos centrais do MCP ao fornecer:

• Ferramentas para executar consultas SQL
• Conexão a bancos de dados MySQL por meio de variáveis de ambiente

Recursos

Ferramentas

• query - Executa consultas SQL
  • Recebe a string de consulta SQL como parâmetro obrigatório
  • Retorna os resultados da consulta

Configuração

Defina as seguintes variáveis de ambiente na configuração do seu servidor MCP:

• MYSQL_HOST: host do servidor MySQL
• MYSQL_USER: nome de usuário do MySQL
• MYSQL_PASSWORD: senha do MySQL
• MYSQL_DATABASE: nome do banco de dados MySQL

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "/path/to/mysql-server/build/index.js",
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-mysql-database"
      }
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.