Repolode
designcomputer

designcomputer/mysql_mcp_server

Um servidor MCP que permite a assistentes de IA, como Claude, explorar e consultar bancos de dados MySQL por meio de um conjunto controlado de ferramentas.

Estrelas
1,408
Forks
260
Issues abertas
4
Último commit
há 10 dias

O que é?

O MySQL MCP Server implementa o Model Context Protocol para que aplicações de IA se conectem a um banco de dados MySQL e trabalhem com o esquema e os dados. Em vez de dar ao modelo acesso irrestrito ao banco, ele oferece um conjunto fixo de ferramentas: executar consultas SQL, inspecionar esquemas de tabelas e amostrar linhas de uma tabela.

Ele funciona via stdio para clientes locais, como Claude Desktop, Claude Code e VS Code, ou via Streamable HTTP (SSE) em implantações remotas. As configurações de conexão vêm de variáveis de ambiente e incluem modos SSL/TLS, tunelamento SSH para acessar bancos de dados privados e um modo multi-database, que funciona em todos os bancos de dados de usuário do servidor quando nenhum banco específico é informado. Senhas e chaves SSH são ocultadas nos logs.

O servidor também oferece dois prompts guiados, explore_database e analyze_table, que encadeiam as ferramentas de esquema e amostragem em fluxos de trabalho com várias etapas. O transporte SSE não tem autenticação integrada, então o projeto recomenda colocá-lo atrás de um proxy reverso quando for exposto além do localhost.

Recursos principais

  • 01Lista tabelas do MySQL como recursos e lê o conteúdo das tabelas
  • 02Executa consultas SQL, incluindo instruções SELECT, SHOW, DESCRIBE e DML
  • 03Retorna detalhes do esquema, como tipos de coluna, possibilidade de valores nulos, valores padrão e comentários
  • 04Amostra até 20 linhas de uma tabela
  • 05Oferece transportes stdio e SSE/HTTP
  • 06Oferece tunelamento SSH, modos SSL/TLS e modo multi-database

Casos de uso

  • Permitir que Claude ou outro assistente de IA responda a perguntas sobre o conteúdo de um banco de dados
  • Explorar o esquema de um banco de dados desconhecido antes de escrever consultas
  • Conceder a uma ferramenta de IA acesso somente de leitura ou escrita limitada a uma instância MySQL de desenvolvimento ou staging
  • Acessar um servidor MySQL privado por meio de um host de salto SSH

Início rápido

  1. 1

    Instale o pacote pelo PyPI

    pip install mysql-mcp-server
  2. 2

    Defina MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD e MYSQL_DATABASE no bloco env da configuração do cliente MCP

  3. 3

    Registre o servidor com o Claude Code CLI

    claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server

Antes de usar

  • Apenas instruções SQL únicas são aceitas; consultas com várias instruções são rejeitadas.
  • O transporte SSE não tem autenticação integrada e precisa de um proxy reverso se for exposto além do localhost.
  • Hosts como o Claude Desktop não carregam o arquivo .env do projeto, então as credenciais devem ser incluídas na configuração do MCP.

Em coleções

Tópicos

Perguntas frequentes

O que é mysql_mcp_server?
Um servidor MCP que permite a assistentes de IA, como Claude, explorar e consultar bancos de dados MySQL por meio de um conjunto controlado de ferramentas. O MySQL MCP Server implementa o Model Context Protocol para que aplicações de IA se conectem a um banco de dados MySQL e trabalhem com o esquema e os dados. Em vez de dar ao modelo acesso irrestrito ao banco, ele oferece um conjunto fixo de ferramentas: executar consultas SQL, inspecionar esquemas de tabelas e amostrar linhas de uma tabela.
mysql_mcp_server é gratuito? Qual é a licença?
mysql_mcp_server é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mysql_mcp_server ainda é mantido?
Manutenção ativa. O último commit de mysql_mcp_server foi em 28 de out. de 2026.
Para que posso usar mysql_mcp_server?
Permitir que Claude ou outro assistente de IA responda a perguntas sobre o conteúdo de um banco de dados Explorar o esquema de um banco de dados desconhecido antes de escrever consultas Conceder a uma ferramenta de IA acesso somente de leitura ou escrita limitada a uma instância MySQL de desenvolvimento ou staging Acessar um servidor MySQL privado por meio de um host de salto SSH
Como instalar mysql_mcp_server?
Instale o pacote pelo PyPI: pip install mysql-mcp-server Defina MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD e MYSQL_DATABASE no bloco env da configuração do cliente MCP Registre o servidor com o Claude Code CLI: claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server
Onde consigo mysql_mcp_server?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/designcomputer/mysql_mcp_server

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados