MySQL MCP Server

MySQL MCP Server

Um servidor MCP poderoso que fornece acesso direto aos bancos de dados MySQL. Este servidor permite que agentes de IA interajam com bancos de dados MySQL, executem consultas SQL e gerenciem o conteúdo do banco de dados por meio de uma interface simples.

Recursos

Recursos (Resources)

• Acesse notas armazenadas no banco de dados via URIs note:///{id}
• Cada nota possui um título e conteúdo
• Tipo MIME de texto simples para acesso fácil ao conteúdo

Ferramentas

• create_note - Crie novas notas de texto no banco de dados
  • Recebe título e conteúdo como parâmetros obrigatórios
  • Armazena a nota no banco de dados MySQL
• list_tables - Liste todas as tabelas no banco de dados conectado
• count_tables - Obtenha o número total de tabelas no banco de dados
• search_tables - Pesquise tabelas usando padrão LIKE
• describe_table - Obtenha a estrutura de uma tabela específica
• execute_sql - Execute consultas SQL personalizadas

Pré-requisitos

• Node.js 18 ou superior
• Servidor MySQL instalado e em execução
• Um banco de dados com as permissões adequadas

Configuração

1. Clone este repositório:

   git clone git@github.com:LeonMelamud/mysql-mcp.git
   cd mysql-mcp
   

2. Instale as dependências:

   npm install
   

3. Crie um arquivo .env na raiz do diretório com os detalhes da sua conexão MySQL:

   MYSQL_HOST=localhost
   MYSQL_USER=your_username
   MYSQL_PASSWORD=your_password
   MYSQL_DATABASE=your_database
   

4. Compile o servidor:

   npm run build
   

Instalação

Para Claude Desktop

Adicione a configuração do servidor ao arquivo de configuração do Claude Desktop:

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

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Para Cline

Adicione a configuração do servidor ao arquivo de configuração MCP do Cline:

No MacOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json No Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Exemplos de Uso

Após a instalação, você pode usar o servidor MySQL MCP em suas conversas com o Claude:

Liste todas as tabelas no banco de dados

Please list all the tables in my MySQL database.

Execute uma consulta SQL

Run this SQL query: SELECT * FROM users LIMIT 5

Crie uma nota

Create a note titled "Meeting Notes" with the content "Discussed project timeline and assigned tasks."

Desenvolvimento

Para desenvolvimento com reconstrução automática:

npm run watch

Depuração

Use o MCP Inspector para depurar o servidor:

npm run inspector

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

Licença

MIT