O que é database-mcp (cocaxcode)?
O database-mcp, publicado no npm como @cocaxcode/database-mcp pelo usuário do GitHub cocaxcode, transforma um cliente MCP em uma pequena bancada de banco de dados para PostgreSQL, MySQL e SQLite. As conexões são salvas uma vez e agrupadas por diretório de projeto, então um agente trabalhando em um repositório só vê os bancos daquele projeto. Em torno das ferramentas de consulta, ele acrescenta busca de esquema em três níveis, EXPLAIN, histórico de consultas por projeto, snapshots antes de cada alteração que geram o SQL inverso para desfazê-la, dumps SQL com restauração e uma compressão de resultados que corta células grandes para economizar contexto.
O código registra 34 ferramentas e 2 recursos de esquema (o README fala em 33, e a ficha do registro MCP, em 19). Ele roda apenas via stdio e carrega o driver postgres, mysql2 ou sql.js que você instalar globalmente. O repositório foi criado em março de 2026, tem 3 estrelas no GitHub e 41 commits, e foi alterado pela última vez em 26 de agosto de 2026; a versão mais recente no npm é a 0.3.4, de 21 de abril de 2026, e o pacote foi baixado 330 vezes no mês até 10 de novembro.
Como instalar database-mcp (cocaxcode)
npx -y @cocaxcode/database-mcp@latestdatabase-mcp (cocaxcode) vale a pena?
Os recursos são bem escolhidos para a máquina de um desenvolvedor. As conexões persistem entre sessões e seguem o diretório do projeto, consultas de leitura recebem LIMIT 100, células acima de 500 bytes são cortadas com uma marca, e um cache de 20 posições deixa o agente buscar o resultado completo depois sem rodar a consulta de novo. Cada INSERT, UPDATE ou DELETE captura antes as linhas afetadas para que o rollback_apply possa revertê-lo; DDL é registrado, mas não pode ser desfeito.
O modelo de segurança é mais fraco do que o README diz. O README promete que operações destrutivas exigem um confirm: true explícito, mas, pela nossa leitura do código-fonte, execute_mutation não tem esse parâmetro e executa um DELETE ou DROP na hora; só conn_delete, rollback_apply e db_restore pedem confirmação, e essa marca é o próprio modelo quem define. Conexões novas são, sim, somente leitura por padrão, o que é a escolha certa, mas conn_set deixa o agente mudar uma conexão para leitura e escrita com uma única chamada.
O próprio modo somente leitura depende de um classificador que olha só a primeira palavra-chave da instrução. O driver de PostgreSQL envia SQL sem parâmetros pelo protocolo simples do postgres.js, e o de SQLite usa o exec do sql.js; ambos executam várias instruções em uma chamada, então uma string que começa com SELECT pode levar um DELETE depois de um ponto e vírgula. explain_query com analyze em true pula totalmente a verificação de somente leitura, e no PostgreSQL o EXPLAIN ANALYZE executa a instrução que explica. Uma injeção de prompt escondida em uma linha que o agente acabou de ler poderia explorar qualquer um dos dois caminhos. O driver de MySQL usa prepared statements e não aceita consultas empilhadas.
As credenciais ficam locais, em arquivos JSON com permissões só do dono em ~/.database-mcp, e conn_get mascara as senhas; conn_export com include_secrets as devolve em texto puro para o contexto do modelo. Histórico, snapshots com valores antigos das linhas e dumps completos são gravados na pasta .database-mcp do projeto, que precisa ficar fora do controle de versão. As descrições das ferramentas e as instruções do servidor estão em espanhol, o que os modelos tiram de letra, mas talvez não quem revisa em inglês os logs do agente.
Nossa opinião: para um arquivo SQLite ou um Postgres local descartável, as ferramentas de desfazer e de histórico são uma melhoria agradável sobre um simples executor de SQL. Para qualquer coisa que importe, o DBHub ou o servidor de Postgres da Microsoft atrás de um usuário de banco que só pode fazer SELECT é o arranjo mais seguro, porque ali quem diz não é o banco, e não uma checagem de palavras-chave.
Onde ele se destaca
Um desenvolvedor solo criando um projeto paralelo em SQLite
Popular dados de teste, testar mudanças de esquema e desfazer erros pelo Claude Code
Crie uma conexão de leitura e escrita para o arquivo .db local, deixe o agente inserir e atualizar linhas e chame rollback_apply quando uma alteração der errado. Gratuito; rode db_dump antes de qualquer DDL, porque mudanças de esquema não podem ser revertidas.
Um desenvolvedor backend freelancer com vários projetos de clientes
Deixar o agente escolher o banco local certo para cada repositório sem reconfigurar
Crie um grupo de conexões por cliente, com o diretório daquele projeto como escopo e um banco de desenvolvimento como padrão. O agente só vê as conexões daquele cliente; conexões de produção ficam melhor totalmente fora da ferramenta.
Antes de decidir
- Configuração
- claude mcp add --scope user database -- npx -y @cocaxcode/database-mcp@latest, mais npm install -g postgres, mysql2 ou sql.js para o mecanismo que você usa; Node 20 ou posterior. Há configurações documentadas para Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex CLI e Gemini CLI. As conexões são criadas pedindo ao agente, então a primeira consulta leva alguns minutos.
- Integrações
- 34 ferramentas no código: 13 de conexões, 7 de grupos, search_schema, execute_query, execute_mutation, explain_query, inspect_last_query, três de dumps, duas de reversão, duas de histórico e duas de configuração, além dos recursos db://schema e db://tables/{tableName}/schema. Só stdio; sem transporte HTTP, portanto sem porta de rede.
- Dados e privacidade
- Tudo roda localmente; os resultados das consultas vão para o seu provedor de modelo. As credenciais ficam sem criptografia em arquivos JSON em ~/.database-mcp/connections, com permissões só do dono; conn_export pode devolvê-las em texto puro. A pasta .database-mcp de cada projeto guarda o histórico (até 5.000 entradas), snapshots com dados de linhas (até 1.000) e dumps SQL completos; resultados recentes ficam em cache no disco por uma hora. Linhas lidas pelo agente podem trazer injeção de prompt, e o modo somente leitura não impede de forma confiável a escrita resultante no PostgreSQL ou no SQLite.
- Custo em escala
- Gratuito; os custos são a carga no banco e o contexto. O LIMIT 100 padrão e o teto de 500 bytes por célula mantêm pequenos os resultados típicos; EXPLAIN ANALYZE e consultas UNION sem limite, que escapam desse teto, não.
- Limites
- Sem configurações próprias de túnel SSH ou certificados, sem tempo limite de consulta e só três mecanismos. A versão 0.3.5 do repositório não está no npm. O modo somente leitura e a confirmação dependem da cooperação do modelo, não das permissões do banco.
O que é bom
- Conexões salvas e agrupadas por diretório de projeto
- Snapshots antes de cada alteração, com reversão por SQL inverso
- LIMIT 100 automático e corte de células para economizar contexto
- Conexões são somente leitura por padrão
O que não é
- execute_mutation não pede confirmação, ao contrário do que diz o README
- Somente leitura contornável com instruções empilhadas e EXPLAIN ANALYZE
- O agente pode mudar sozinho uma conexão para leitura e escrita
- Três estrelas, um desenvolvedor, nenhuma versão no npm desde abril de 2026
Ideal para
Desenvolvedores solo que querem que um agente explore e edite um banco SQLite local ou um Postgres de desenvolvimento, com desfazer e histórico.
Alternativas ao database-mcp (cocaxcode)
database-mcp (cocaxcode): perguntas frequentes
- database-mcp (cocaxcode) vale a pena?
- Recursos de bancada bem pensados se apoiam em promessas de segurança que o código não cumpre, então o lugar dele é um banco no notebook, nunca perto da produção. Damos nota 2.9 de 5.
- Quanto custa database-mcp (cocaxcode)?
- Gratuito e de código aberto (MIT).
- Quais são as desvantagens de database-mcp (cocaxcode)?
- execute_mutation não pede confirmação, ao contrário do que diz o README; somente leitura contornável com instruções empilhadas e EXPLAIN ANALYZE; o agente pode mudar sozinho uma conexão para leitura e escrita; três estrelas, um desenvolvedor, nenhuma versão no npm desde abril de 2026.
- Para quem database-mcp (cocaxcode) é indicado?
- Desenvolvedores solo que querem que um agente explore e edite um banco SQLite local ou um Postgres de desenvolvimento, com desfazer e histórico.
- Quanto custa database-mcp (cocaxcode) para uma equipe ou em produção?
- Gratuito; os custos são a carga no banco e o contexto. O LIMIT 100 padrão e o teto de 500 bytes por célula mantêm pequenos os resultados típicos; EXPLAIN ANALYZE e consultas UNION sem limite, que escapam desse teto, não.
- database-mcp (cocaxcode) é seguro para dados da empresa?
- Tudo roda localmente; os resultados das consultas vão para o seu provedor de modelo. As credenciais ficam sem criptografia em arquivos JSON em ~/.database-mcp/connections, com permissões só do dono; conn_export pode devolvê-las em texto puro. A pasta .database-mcp de cada projeto guarda o histórico (até 5.000 entradas), snapshots com dados de linhas (até 1.000) e dumps SQL completos; resultados recentes ficam em cache no disco por uma hora. Linhas lidas pelo agente podem trazer injeção de prompt, e o modo somente leitura não impede de forma confiável a escrita resultante no PostgreSQL ou no SQLite.
- Quais são as melhores alternativas ao database-mcp (cocaxcode)?
- As alternativas mais próximas que analisamos são DBHub, Postgres MCP Server (Microsoft), Faucet e MCP Toolbox for Databases.
Respostas verificadas em 11 de nov. de 2026.