Dory MCP Server
executa o Dory sem o cliente desktop. É o ponto de entrada autônomo para servidores MCP, automação e execução direta de Ações do Dory.
Documentação
Dory
Dory é um cliente SQL nativo de IA para humanos e agentes.
Dory é um espaço de trabalho SQL onde humanos podem consultar, explorar e visualizar dados, e onde agentes de IA podem trabalhar com bancos de dados com segurança por meio do MCP.
Diferente de um servidor MCP de banco de dados comum, que apenas envia resultados de consultas de volta para um chat, Dory transforma o trabalho dos agentes em espaços de trabalho SQL editáveis: abas SQL, conjuntos de resultados, gráficos, consultas salvas e contexto de execução podem ser abertos, inspecionados, modificados e continuados por humanos.
Use o Dory como seu cliente SQL do dia a dia, ou como a camada de execução de banco de dados para agentes como Claude Code, Codex CLI e outras ferramentas compatíveis com MCP.
🍺 Instalar via Homebrew • 🍎 Baixar para macOS • Baixar para Windows • 📦 Início Rápido • 🏠 Auto-hospedagem • Guia MCP • 🤝 Contribuindo • ⭐ Estrela
Nenhum cadastro necessário. Clique em "Experimente o Dory sem uma conta" para começar instantaneamente.

Por que Dory?
Agentes de IA agora podem escrever SQL, inspecionar esquemas e responder perguntas analíticas. Mas a saída bruta dos agentes não é suficiente para o trabalho real com dados.
As equipes ainda precisam de:
- ver o SQL exato que foi executado
- inspecionar conjuntos de resultados reais
- corrigir consultas erradas
- transformar resultados em gráficos ou exportações
- preservar o contexto em várias etapas
- continuar o trabalho em um espaço de trabalho SQL real
Dory foi construído para esse fluxo de trabalho.
Como o Dory funciona
Dory fornece as mesmas ações subjacentes de banco de dados tanto para a interface quanto para os agentes:
- Humanos usam o Dory como um cliente SQL: escrevem SQL, navegam pelo esquema, executam consultas, filtram resultados, criam gráficos e salvam consultas.
- Agentes usam o Dory por meio do MCP: listam conexões, exploram esquemas, executam SQL somente leitura, criam abas e organizam o trabalho com o banco de dados.
- O trabalho gerado pelos agentes se torna um espaço de trabalho real que os humanos podem revisar, editar e continuar.
Dory vs. um servidor MCP de banco de dados comum
| Recurso | Servidor MCP de BD comum | Dory |
|---|---|---|
| Executar SQL a partir de agentes | ✅ | ✅ |
| Explorar esquema | ✅ | ✅ |
| Abas SQL editáveis | ❌ | ✅ |
| Conjuntos de resultados persistentes | ❌ | ✅ |
| Gráficos e filtros | ❌ | ✅ |
| Fluxo de revisão humana | Limitado | ✅ |
| Consultas salvas e contexto do espaço de trabalho | Limitado | ✅ |
| Funciona como cliente SQL diário | ❌ | ✅ |
✨ Recursos Principais
Espaços de Trabalho de Agentes Editáveis
O trabalho do agente com o banco de dados não deve desaparecer em uma transcrição de chat.
- Abra abas SQL criadas por agentes como abas normais do espaço de trabalho
- Inspecione SQL, conjuntos de resultados, filtros, gráficos e contexto salvo
- Edite o SQL gerado e execute-o novamente você mesmo
- Continue uma execução do agente no mesmo espaço de trabalho em vez de recomeçar do zero
Dory CLI e MCP para Agentes
@getdory/cli é o ponto de entrada do agente para executar o Dory sem abrir o aplicativo desktop.
- Funciona com Claude Code, Codex CLI e outros clientes compatíveis com MCP
- Executa servidores MCP autônomos via stdio ou HTTP
- Atua como um runtime headless para automação e Ações Dory diretas
- Pode usar dados autônomos, Dory Web hospedado ou dados locais do Desktop com
--data desktop
Espaço de Trabalho SQL para Humanos
- Editor SQL com múltiplas abas e múltiplos conjuntos de resultados
- Navegador de esquema para tabelas, colunas e objetos de banco de dados
- Consultas salvas para análises reutilizáveis
- Histórico de execução de consultas integrado e contexto do espaço de trabalho
Explorador de Esquema
Entenda bancos de dados desconhecidos rapidamente com um mapa interativo de tabelas e relacionamentos.
- Visualize chaves primárias, chaves estrangeiras e relacionamentos entre esquemas
- Pesquise tabelas, selecione esquemas e alterne entre todas as colunas e apenas chaves
- Organize automaticamente o grafo, ajuste-o à janela de visualização e abra qualquer tabela diretamente
- Exporte o grafo completo do esquema como PNG ou SVG

Conjuntos de Resultados, Filtros e Gráficos
- Inspecione conjuntos de resultados reais em uma visualização de tabela
- Filtre, pesquise e revise as linhas retornadas
- Transforme a saída da consulta em gráficos diretamente no espaço de trabalho
- Mantenha os resultados anexados ao SQL que os produziu
Assistência de IA com Consciência de Esquema
Um assistente de IA fundamentado no esquema real do banco de dados e no contexto atual da consulta.
- Gere SQL a partir de linguagem natural
- Reescreva, corrija e explique SQL na aba atual
- Use o esquema atual do banco de dados e o contexto da consulta
- Mantenha a assistência de IA dentro do espaço de trabalho SQL real
Consultas Salvas e Contexto Reutilizável
- Salve SQL útil como consultas reutilizáveis
- Organize o trabalho de consultas entre conexões e espaços de trabalho
- Permita que humanos e agentes construam a partir de trabalhos anteriores com o banco de dados
- Preserve o contexto além de uma única resposta de chat
Suporte a Bancos de Dados
Dory é um cliente SQL multi-banco de dados, com amplo suporte a drivers e integrações mais profundas onde o Dory pode oferecer mais do que a execução genérica de SQL.
| Banco de Dados | Status |
|---|---|
| ✅ Profundamente integrado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado | |
| ✅ Suportado |
Integração Profunda com ClickHouse
Dory inclui superfícies de operações nativas do ClickHouse para equipes que precisam de mais do que um editor SQL genérico.
- Monitoramento de consultas com consultas lentas, erros, usuários ativos, latência e throughput
- Filtragem multidimensional por usuário, banco de dados, tipo de consulta e intervalo de tempo
- Gerenciamento de usuários e papéis sem escrever manualmente cada instrução
GRANTouCREATE USER - Operações de privilégios em nível de cluster com suporte a On Cluster

🚀 Início Rápido
Instalar no macOS com Homebrew
brew install dorylab/dory/dory
Executar com Docker
Certifique-se de que o Docker esteja instalado e execute:
docker run -d --name dory \
-p 3000:3000 \
-e DS_SECRET_KEY="$(openssl rand -base64 32 | tr -d '\n')" \
-e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-e BETTER_AUTH_URL="http://localhost:3000" \
-e DORY_AI_PROVIDER=openai \
-e DORY_AI_MODEL=gpt-4o-mini \
-e DORY_AI_API_KEY=your_api_key_here \
-e DORY_AI_URL=https://api.openai.com/v1 \
-e NEXT_PUBLIC_REQUIRE_EMAIL_VERIFICATION=false \
-e DORY_INIT_USER_EMAIL=admin@getdory.dev \
-e DORY_INIT_USER_PASSWORD=admin \
dorylab/dory:latest
Em seguida:
Username: admin@getdory.dev
Password: admin
A conta de administrador inicial é controlada por DORY_INIT_USER_EMAIL e DORY_INIT_USER_PASSWORD em .env.
Para habilitar a verificação de e-mail, defina RESEND_API_KEY como uma chave resend válida e EMAIL_FROM como um e-mail validado.
Auto-hospedar com Docker Compose
Para implantações auto-hospedadas de longo prazo, o Docker Compose executa o Dory com um banco de dados PostgreSQL dedicado e volumes persistentes.
cp docker-compose.env.example .env
# Edit .env and replace all placeholder secrets/passwords.
docker compose up -d
Para documentação abrangente de auto-hospedagem, variáveis de ambiente e guias de implantação, consulte a Documentação de Auto-hospedagem.
🧩 Habilidade do Agente Dory
Instale a habilidade Dory para Codex, ChatGPT, Claude e outros agentes que suportam o formato aberto de Habilidades de Agente.
npx skills add https://github.com/dorylab/skills --skill dory
A habilidade ensina os agentes quando usar o Dory, como usar as ferramentas MCP do Dory e como preservar SQL gerado, conjuntos de resultados e descobertas em um espaço de trabalho editável de Execução do Agente Dory.
A habilidade não instala o Dory CLI nem configura o MCP automaticamente. Para acesso ao banco de dados ao vivo, conecte o Dory MCP com os comandos de configuração abaixo.
🔗 Dory CLI e MCP
Use @getdory/cli para conectar agentes compatíveis com MCP ao Dory. Ele pode executar um servidor MCP stdio local, hospedar um endpoint MCP HTTP de longa duração, fazer a ponte para o Dory Web hospedado ou reutilizar dados locais do Dory Desktop com --data desktop.
Para o guia completo de configuração do MCP, incluindo opções de CLI stdio, HTTP headless e ponte para o Dory hospedado, consulte Guia MCP do Dory.
Execute um servidor MCP stdio local quando seu cliente de agente estiver na mesma máquina:
codex mcp add dory -- npx -y @getdory/cli mcp serve --stdio --data standalone
codex mcp list
claude mcp add dory -- npx -y @getdory/cli mcp serve --stdio --data standalone
claude mcp list
Execute um endpoint MCP HTTP local quando quiser um serviço de longa duração:
npx -y @getdory/cli mcp token create --data standalone --name "local-http"
export DORY_MCP_TOKEN="dory_mcp_..."
npx -y @getdory/cli mcp serve \
--http \
--host 127.0.0.1 \
--port 3318 \
--token "$DORY_MCP_TOKEN" \
--data standalone
Adicione esse endpoint HTTP ao Codex CLI:
codex mcp add \
--url http://127.0.0.1:3318/api/mcp \
--bearer-token-env-var DORY_MCP_TOKEN \
dory
Adicione-o ao Claude Code:
claude mcp add \
--transport http \
dory \
http://127.0.0.1:3318/api/mcp \
--header "Authorization: Bearer $DORY_MCP_TOKEN"
Faça a ponte do Dory Web hospedado para clientes MCP locais:
npx -y @getdory/cli mcp login --url https://your-dory-host
codex mcp add dory-hosted -- npx -y @getdory/cli mcp bridge --url https://your-dory-host
claude mcp add dory-hosted -- npx -y @getdory/cli mcp bridge --url https://your-dory-host
Para o pacote de ponte autônomo @getdory/mcp, consulte packages/mcp. Para o guia completo de CLI e runtime headless, consulte packages/cli.
🧠 Provedores de IA Suportados
Dory é construído com uma arquitetura de provedores de IA plugável. Você pode alternar livremente entre diferentes fornecedores de modelos alterando variáveis de ambiente, sem necessidade de mudanças no código.
Provedores atualmente suportados:
| Provedor | Env DORY_AI_PROVIDER | Descrição |
|---|---|---|
| OpenAI | openai | Provedor padrão. Usa a API oficial da OpenAI. |
| Compatível com OpenAI | openai-compatible | Qualquer serviço que exponha uma API compatível com OpenAI. |
| Anthropic | anthropic | Modelos Claude via API oficial da Anthropic. |
google | Modelos Gemini via API Google Generative AI. | |
| Qwen (Alibaba) | qwen | Modelos Qwen via endpoint DashScope compatível com OpenAI. |
| xAI | xai | Modelos Grok via API xAI. |
🗺️ Roadmap
Veja o roadmap mais recente aqui:
- Roadmap do Dory
- Referência histórica: Discussão no GitHub #35
⚙️ Stack Tecnológico
- Next.js + React + Tailwind
- Drizzle ORM
- Integração de SDK de IA multimodelo
- PGLite
- Resend
- Shadcn UI
- Monaco Editor
🎯 Para quem é?
- Engenheiros de dados
- Analistas de dados
- Equipes de plataforma de banco de dados
- Construtores de agentes que precisam de uma camada de execução de banco de dados
- Equipes de operações do ClickHouse
Seus dados continuam seus. Exceto por solicitações de IA enviadas pelo Cloudflare Gateway, tudo — conexões, abas, resultados e consultas salvas — é armazenado localmente no seu dispositivo.
📄 Licença
Apache-2.0