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 Logo

Dory

SourceForge Rising Star Award SourceForge Users Love Us Award

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.

Dory AI-native SQL workspace

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

RecursoServidor MCP de BD comumDory
Executar SQL a partir de agentes✅✅
Explorar esquema✅✅
Abas SQL editáveis❌✅
Conjuntos de resultados persistentes❌✅
Gráficos e filtros❌✅
Fluxo de revisão humanaLimitado✅
Consultas salvas e contexto do espaço de trabalhoLimitado✅
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

Dory Schema Explorer


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 DadosStatus
ClickHouse ClickHouse✅ Profundamente integrado
PostgreSQL PostgreSQL✅ Suportado
Neon Neon✅ Suportado
Supabase Supabase✅ Suportado
Cloudflare D1 Cloudflare D1✅ Suportado
MySQL MySQL✅ Suportado
MariaDB MariaDB✅ Suportado
SQLite SQLite✅ Suportado
DuckDB DuckDB✅ Suportado
SQL Server SQL Server✅ Suportado
Oracle Oracle✅ Suportado
Snowflake Snowflake✅ 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 GRANT ou CREATE USER
  • Operações de privilégios em nível de cluster com suporte a On Cluster

Dory ClickHouse monitoring

🚀 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:

ProvedorEnv DORY_AI_PROVIDERDescrição
OpenAIopenaiProvedor padrão. Usa a API oficial da OpenAI.
Compatível com OpenAIopenai-compatibleQualquer serviço que exponha uma API compatível com OpenAI.
AnthropicanthropicModelos Claude via API oficial da Anthropic.
GooglegoogleModelos Gemini via API Google Generative AI.
Qwen (Alibaba)qwenModelos Qwen via endpoint DashScope compatível com OpenAI.
xAIxaiModelos Grok via API xAI.

🗺️ Roadmap

Veja o roadmap mais recente aqui:

⚙️ 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