MySQL MCP Server

@davewind/mysql-mcp-server

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.

Principais Recursos

1. Acesso Somente Leitura ao Banco de Dados: Impõe operações somente leitura por meio de validação SQL e transações READ ONLY
2. Descoberta de Esquema: Identifica e expõe automaticamente as estruturas das tabelas do banco de dados
3. Execução de Consultas SQL: Fornece uma ferramenta de consulta que aceita e executa instruções SELECT
4. Conformidade com o Model Context Protocol: Implementa a especificação MCP para integração perfeita com LLMs compatíveis
5. Configuração Simples: Configuração fácil com o mínimo de configuração necessária

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 READ ONLY

Recursos

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

• Esquemas de Tabela (mysql://user:password@localhost:3306/database)
  • 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

Instalação

npm install @davewind/mysql-mcp-server -g

Configuração

Arquivo de configuração de configurações MCP:

uso recomendado

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@davewind/mysql-mcp-server", "mysql://user:password@localhost:port/database"],
    }
  }
}

Teste

Substitua mysql://user:password@localhost:port/ e execute npm run inspector

  "scripts": {
    "inspector": "npx @modelcontextprotocol/inspector@0.10.2 build/index.js mysql://user:password@localhost:port/database
  }

Ambiente

node v18 +

Arquitetura do Sistema

O MySQL MCP Server atua como intermediário entre LLMs e bancos de dados MySQL, processando solicitações de acordo com o Model Context Protocol.

Interação entre Componentes

Interação entre Componentes

Modelo de Segurança

O MySQL MCP Server implementa um modelo de segurança rigoroso para garantir que o acesso ao banco de dados seja somente leitura.

As medidas de segurança incluem:

1. Validação de consultas SQL para permitir apenas instruções SELECT
2. Execução de todas as consultas dentro de transações READ ONLY
3. Sem suporte para operações de modificação de dados (INSERT, UPDATE, DELETE, etc.)
4. Sem suporte para modificação de esquema do banco de dados (CREATE, ALTER, DROP, etc.)

Integração com LLMs

O MySQL MCP Server é projetado para funcionar com qualquer sistema LLM que suporte o Model Context Protocol. Ele se comunica via JSON-RPC sobre stdio, seguindo a especificação MCP.

Licença

MIT