Database

Servidor MCP de banco de dados para MySQL, MariaDB, PostgreSQL e SQLite

Documentação

Database MCP

Um servidor MCP de binário único para bancos de dados SQL. Conecte seu assistente de IA ao MySQL/MariaDB, PostgreSQL ou SQLite sem dependências de runtime.

Website · Documentação · Releases

demo

Recursos ✨

Multi-banco — MySQL/MariaDB, PostgreSQL e SQLite a partir de um único binário
Ferramentas MCP — descoberta de schema (listDatabases, listTables, listViews, listTriggers, listFunctions, listProcedures, listMaterializedViews), acesso a dados (readQuery, writeQuery), DDL (createDatabase, dropDatabase, dropTable) e explainQuery. O modo somente leitura oculta as ferramentas de escrita (writeQuery, createDatabase, dropDatabase, dropTable). Consulte Ferramentas MCP para disponibilidade por backend.
Binário único — ~7 MB, sem necessidade de Python/Node/Docker
Múltiplos transportes — stdio (para Claude Desktop, Cursor) e HTTP (para remoto/multi-cliente)
Configuração em duas camadas — flags de CLI > variáveis de ambiente, com padrões sensatos por backend

Instalação 📦

macOS, Linux, WSL:

curl -fsSL https://dbmcp.haymon.ai/install.sh | bash

Windows PowerShell:

irm https://dbmcp.haymon.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://dbmcp.haymon.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Consulte a documentação de instalação para Docker, Cargo e outros métodos.

Início Rápido 🚀

Usando `.mcp.json` (recomendado)

Adicione um arquivo .mcp.json à raiz do seu projeto. Os clientes MCP leem este arquivo e configuram o servidor automaticamente.

Transporte stdio — o cliente inicia e gerencia o processo do servidor:

{
  "mcpServers": {
    "dbmcp": {
      "command": "dbmcp",
      "args": ["stdio"],
      "env": {
        "DB_BACKEND": "mysql",
        "DB_HOST": "127.0.0.1",
        "DB_PORT": "3306",
        "DB_USER": "root",
        "DB_PASSWORD": "secret",
        "DB_NAME": "mydb"
      }
    }
  }
}

Transporte HTTP — você inicia o servidor manualmente e o cliente se conecta a ele:

# Start the server first
dbmcp http --db-backend mysql --db-user root --db-name mydb --port 9001

{
  "mcpServers": {
    "dbmcp": {
      "type": "http",
      "url": "http://127.0.0.1:9001/mcp"
    }
  }
}

Nota: O campo "type": "http" é obrigatório para o transporte HTTP. Sem ele, clientes como Claude Code rejeitarão a configuração.

Usando flags de CLI

# MySQL/MariaDB
dbmcp stdio --db-backend mysql --db-host localhost --db-user root --db-name mydb

# PostgreSQL
dbmcp stdio --db-backend postgres --db-host localhost --db-user postgres --db-name mydb

# SQLite
dbmcp stdio --db-backend sqlite --db-name ./data.db

# HTTP transport
dbmcp http --db-backend mysql --db-user root --db-name mydb --host 0.0.0.0 --port 9001

Usando variáveis de ambiente

DB_BACKEND=mysql DB_USER=root DB_NAME=mydb dbmcp stdio

Configuração ⚙️

A configuração é carregada com precedência clara:

Flags de CLI > variáveis de ambiente > padrões

As variáveis de ambiente são normalmente definidas pelo seu cliente MCP (via env ou envFile na configuração do servidor).

Subcomandos

Subcomando	Descrição
`stdio`	Executa em modo stdio
`http`	Executa em modo HTTP/SSE
`version`	Exibe informações de versão e sai

Um subcomando é obrigatório — executar dbmcp sem subcomando exibe a ajuda de uso e sai com status não zero.

Opções de Banco de Dados (compartilhadas entre subcomandos)

Flag	Variável de Ambiente	Padrão	Descrição
`--db-backend`	`DB_BACKEND`	(obrigatório)	`mysql`, `mariadb`, `postgres` ou `sqlite`
`--db-host`	`DB_HOST`	`localhost`	Host do banco de dados
`--db-port`	`DB_PORT`	padrão do backend	`3306` (MySQL/MariaDB), `5432` (PostgreSQL)
`--db-user`	`DB_USER`	padrão do backend	`root` (MySQL/MariaDB), `postgres` (PostgreSQL)
`--db-password`	`DB_PASSWORD`	(vazio)	Senha do banco de dados
`--db-name`	`DB_NAME`	(vazio)	Nome do banco de dados ou caminho do arquivo SQLite
`--db-charset`	`DB_CHARSET`		Conjunto de caracteres (somente MySQL/MariaDB)

Opções SSL/TLS

Flag	Variável de Ambiente	Padrão	Descrição
`--db-ssl`	`DB_SSL`	`false`	Habilita SSL
`--db-ssl-ca`	`DB_SSL_CA`		Caminho do certificado CA
`--db-ssl-cert`	`DB_SSL_CERT`		Caminho do certificado do cliente
`--db-ssl-key`	`DB_SSL_KEY`		Caminho da chave do cliente
`--db-ssl-verify-cert`	`DB_SSL_VERIFY_CERT`	`true`	Verifica o certificado do servidor

Opções do Servidor

Flag	Variável de Ambiente	Padrão	Descrição
`--db-read-only`	`DB_READ_ONLY`	`true`	Bloqueia consultas de escrita
`--db-max-pool-size`	`DB_MAX_POOL_SIZE`	`5`	Tamanho máximo do pool de conexões (mín: 1)
`--db-connection-timeout`	`DB_CONNECTION_TIMEOUT`	(não definido)	Tempo limite de conexão em segundos (mín: 1)
`--db-query-timeout`	`DB_QUERY_TIMEOUT`	`30`	Tempo limite de execução de consulta em segundos
`--db-page-size`	`DB_PAGE_SIZE`	`100`	Máximo de itens por resposta de ferramenta paginada (intervalo 1–500)

Opções de Log

Flag	Variável de Ambiente	Padrão	Descrição
`--log-level`	`LOG_LEVEL`	`info`	Nível de log (trace/debug/info/warn/error)

Opções exclusivas de HTTP (disponíveis apenas com o subcomando `http`)

Flag	Padrão	Descrição
`--host`	`127.0.0.1`	Host de vinculação
`--port`	`9001`	Porta de vinculação
`--allowed-origins`	variantes de localhost	Origens de navegador permitidas (separadas por vírgula). Controla tanto o preflight CORS quanto a rejeição de Origin no lado do servidor.
`--allowed-hosts`	`localhost,127.0.0.1,::1`	Cabeçalhos Host confiáveis (separados por vírgula). Aplicados no lado do servidor; `:authority` HTTP/2 é respeitado.

Ferramentas MCP 🧩

listDatabases

Lista bancos de dados acessíveis, paginados via cursor / nextCursor. Consulte Paginação por Cursor para detalhes de iteração. Não disponível para SQLite.

listTables

Lista tabelas em um banco de dados, paginadas via cursor / nextCursor. Consulte Paginação por Cursor para detalhes de iteração.

Parâmetros: database (padrão: banco de dados ativo; SQLite não tem parâmetro database), cursor, search, detailed.

search é um padrão opcional LIKE/ILIKE que não diferencia maiúsculas de minúsculas, com % (qualquer sequência) e _ (caractere único) como curingas — passe users% para corresponder a nomes que começam com users, ou %order% para correspondência de substring. Uma palavra simples sem curingas corresponde apenas a um nome de tabela exato.