Dory MCP Server

ejecuta Dory sin el cliente de escritorio. Es el punto de entrada independiente para servidores MCP, automatización y ejecución directa de Dory Action.

GitHub
291
Prueba este MCPPatrocinado

Documentación

Dory Logo

Dory

SourceForge Rising Star Award SourceForge Users Love Us Award

Dory es un cliente SQL nativo de IA para humanos y agentes.

Dory es un espacio de trabajo SQL donde los humanos pueden consultar, explorar y visualizar datos, y donde los agentes de IA pueden trabajar de forma segura con bases de datos a través de MCP.

A diferencia de un servidor MCP de base de datos simple que solo envía resultados de consultas de vuelta a un chat, Dory convierte el trabajo de los agentes en espacios de trabajo SQL editables: pestañas SQL, conjuntos de resultados, gráficos, consultas guardadas y contexto de ejecución pueden abrirse, inspeccionarse, modificarse y continuarse por humanos.

Usa Dory como tu cliente SQL de uso diario, o como la capa de ejecución de bases de datos para agentes como Claude Code, Codex CLI y otras herramientas compatibles con MCP.

🍺 Instalar vía Homebrew   •   🍎 Descargar para macOS   •   Descargar para Windows   •   📦 Inicio rápido   •   🏠 Autoalojamiento   •   Guía de MCP   •   🤝 Contribuciones   •   ⭐ Estrella

No se requiere registro. Haz clic en "Probar Dory sin una cuenta" para comenzar al instante.

Dory AI-native SQL workspace

¿Por qué Dory?

Los agentes de IA ahora pueden escribir SQL, inspeccionar esquemas y responder preguntas analíticas. Pero la salida bruta de los agentes no es suficiente para el trabajo real con datos.

Los equipos aún necesitan:

  • ver el SQL exacto que se ejecutó
  • inspeccionar conjuntos de resultados reales
  • corregir consultas incorrectas
  • convertir resultados en gráficos o exportaciones
  • preservar el contexto a lo largo de múltiples pasos
  • continuar el trabajo en un espacio de trabajo SQL real

Dory está construido para este flujo de trabajo.

Cómo funciona Dory

Dory proporciona las mismas acciones subyacentes de base de datos tanto a la interfaz de usuario como a los agentes:

  • Los humanos usan Dory como un cliente SQL: escriben SQL, exploran esquemas, ejecutan consultas, filtran resultados, crean gráficos y guardan consultas.
  • Los agentes usan Dory a través de MCP: listan conexiones, exploran esquemas, ejecutan SQL de solo lectura, crean pestañas y organizan el trabajo de bases de datos.
  • El trabajo generado por agentes se convierte en un espacio de trabajo real que los humanos pueden revisar, editar y continuar.

Dory vs un servidor MCP de base de datos simple

CapacidadServidor MCP de BD simpleDory
Ejecutar SQL desde agentes✅✅
Explorar esquemas✅✅
Pestañas SQL editables❌✅
Conjuntos de resultados persistentes❌✅
Gráficos y filtros❌✅
Flujo de revisión humanaLimitado✅
Consultas guardadas y contexto de espacio de trabajoLimitado✅
Funciona como cliente SQL diario❌✅

✨ Características clave

Espacios de trabajo de agentes editables

El trabajo de bases de datos de los agentes no debería desaparecer en una transcripción de chat.

  • Abre pestañas SQL creadas por agentes como pestañas normales del espacio de trabajo
  • Inspecciona SQL, conjuntos de resultados, filtros, gráficos y contexto guardado
  • Edita el SQL generado y vuelve a ejecutarlo tú mismo
  • Continúa una ejecución de agente desde el mismo espacio de trabajo en lugar de reiniciar desde cero

CLI de Dory y MCP para agentes

@getdory/cli es el punto de entrada de agente para ejecutar Dory sin abrir la aplicación de escritorio.

  • Funciona con Claude Code, Codex CLI y otros clientes compatibles con MCP
  • Ejecuta servidores MCP independientes sobre stdio o HTTP
  • Actúa como un runtime sin interfaz para automatización y Acciones Directas de Dory
  • Puede usar datos independientes, Dory Web alojado o datos locales de Desktop con --data desktop

Espacio de trabajo SQL para humanos

  • Editor SQL de múltiples pestañas con múltiples conjuntos de resultados
  • Explorador de esquemas para tablas, columnas y objetos de base de datos
  • Consultas guardadas para análisis reutilizables
  • Historial de ejecución de consultas integrado y contexto de espacio de trabajo

Explorador de esquemas

Comprende bases de datos desconocidas de un vistazo con un mapa interactivo de tablas y relaciones.

  • Visualiza claves primarias, claves foráneas y relaciones entre esquemas
  • Busca tablas, selecciona esquemas y alterna entre todas las columnas y solo claves
  • Organiza automáticamente el gráfico, ajústalo a la vista y abre cualquier tabla directamente
  • Exporta el gráfico de esquema completo como PNG o SVG

Dory Schema Explorer

Conjuntos de resultados, filtros y gráficos

  • Inspecciona conjuntos de resultados reales en una vista de tabla
  • Filtra, busca y revisa filas devueltas
  • Convierte la salida de consultas en gráficos directamente dentro del espacio de trabajo
  • Mantén los resultados adjuntos al SQL que los produjo

Asistencia de IA consciente del esquema

Un asistente de IA basado en el esquema real de la base de datos y el contexto actual de la consulta.

  • Genera SQL a partir de lenguaje natural
  • Reescribe, corrige y explica SQL en la pestaña actual
  • Usa el esquema de base de datos actual y el contexto de consulta
  • Mantén la asistencia de IA dentro del espacio de trabajo SQL real

Consultas guardadas y contexto reutilizable

  • Guarda SQL útil como consultas reutilizables
  • Organiza el trabajo de consultas entre conexiones y espacios de trabajo
  • Permite que humanos y agentes construyan sobre trabajo de bases de datos previo
  • Preserva el contexto más allá de una sola respuesta de chat

Soporte de bases de datos

Dory es un cliente SQL multibase de datos, con soporte amplio de controladores e integraciones más profundas donde Dory puede ofrecer más que la ejecución SQL genérica.

Base de datosEstado
ClickHouse ClickHouse✅ Integración profunda
PostgreSQL PostgreSQL✅ Compatible
Neon Neon✅ Compatible
Supabase Supabase✅ Compatible
Cloudflare D1 Cloudflare D1✅ Compatible
MySQL MySQL✅ Compatible
MariaDB MariaDB✅ Compatible
SQLite SQLite✅ Compatible
DuckDB DuckDB✅ Compatible
SQL Server SQL Server✅ Compatible
Oracle Oracle✅ Compatible
Snowflake Snowflake✅ Compatible

Integración profunda con ClickHouse

Dory incluye superficies de operaciones nativas de ClickHouse para equipos que necesitan más que un editor SQL genérico.

  • Monitoreo de consultas con consultas lentas, errores, usuarios activos, latencia y rendimiento
  • Filtrado multidimensional por usuario, base de datos, tipo de consulta y rango de tiempo
  • Gestión de usuarios y roles sin escribir manualmente cada sentencia GRANT o CREATE USER
  • Operaciones de privilegios a nivel de clúster con soporte On Cluster

Dory ClickHouse monitoring

🚀 Inicio rápido

Instalar en macOS con Homebrew

brew install dorylab/dory/dory

Ejecutar con Docker

Asegúrate de que Docker esté instalado y luego ejecuta:

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

Luego:

Username: admin@getdory.dev

Password: admin

La cuenta de administrador inicial está controlada por DORY_INIT_USER_EMAIL y DORY_INIT_USER_PASSWORD en .env.

Para habilitar la verificación de correo electrónico, establece RESEND_API_KEY a una clave válida de resend y EMAIL_FROM a un correo electrónico validado.

Autoalojamiento con Docker Compose

Para implementaciones autoalojadas de larga duración, Docker Compose ejecuta Dory con una base de datos PostgreSQL dedicada y volúmenes persistentes.

cp docker-compose.env.example .env
# Edit .env and replace all placeholder secrets/passwords.
docker compose up -d

Para documentación completa de autoalojamiento, variables de entorno y guías de implementación, consulta la Documentación de Autoalojamiento.

🧩 Habilidad de agente de Dory

Instala la habilidad de Dory para Codex, ChatGPT, Claude y otros agentes que admiten el formato abierto de Habilidades de Agente.

npx skills add https://github.com/dorylab/skills --skill dory

La habilidad enseña a los agentes cuándo usar Dory, cómo usar las herramientas MCP de Dory y cómo preservar el SQL generado, los conjuntos de resultados y los hallazgos en un espacio de trabajo editable de Ejecución de Agente de Dory.

La habilidad no instala el CLI de Dory ni configura MCP automáticamente. Para acceso a bases de datos en vivo, conecta Dory MCP con los comandos de configuración a continuación.

🔗 CLI de Dory y MCP

Usa @getdory/cli para conectar agentes compatibles con MCP a Dory. Puede ejecutar un servidor MCP local de stdio, alojar un endpoint MCP HTTP de larga duración, conectarse a Dory Web alojado o reutilizar datos locales de Dory Desktop con --data desktop.

Para la guía completa de configuración de MCP, incluidas las opciones de CLI stdio, HTTP sin interfaz y puente de Dory alojado, consulta Guía de MCP de Dory.

Ejecuta un servidor MCP local de stdio cuando tu cliente de agente esté en la misma 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

Ejecuta un endpoint MCP HTTP local cuando quieras un servicio de larga duración:

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

Agrega ese endpoint HTTP a Codex CLI:

codex mcp add \
  --url http://127.0.0.1:3318/api/mcp \
  --bearer-token-env-var DORY_MCP_TOKEN \
  dory

Agrégalo a Claude Code:

claude mcp add \
  --transport http \
  dory \
  http://127.0.0.1:3318/api/mcp \
  --header "Authorization: Bearer $DORY_MCP_TOKEN"

Conecta Dory Web alojado a clientes MCP locales:

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 el paquete de puente independiente @getdory/mcp, consulta packages/mcp. Para la guía completa de CLI y runtime sin interfaz, consulta packages/cli.

🧠 Proveedores de IA compatibles

Dory está construido con una arquitectura de proveedores de IA conectables. Puedes cambiar libremente entre diferentes proveedores de modelos cambiando variables de entorno, sin necesidad de cambios de código.

Proveedores actualmente compatibles:

ProveedorEnv DORY_AI_PROVIDERDescripción
OpenAIopenaiProveedor predeterminado. Usa la API oficial de OpenAI.
Compatible con OpenAIopenai-compatibleCualquier servicio que exponga una API compatible con OpenAI.
AnthropicanthropicModelos Claude a través de la API oficial de Anthropic.
GooglegoogleModelos Gemini a través de la API de Google Generative AI.
Qwen (Alibaba)qwenModelos Qwen a través del endpoint compatible con OpenAI de DashScope.
xAIxaiModelos Grok a través de la API de xAI.

🗺️ Hoja de ruta

Consulta la hoja de ruta más reciente aquí:

⚙️ Pila tecnológica

  • Next.js + React + Tailwind
  • Drizzle ORM
  • Integración de SDK de IA multimodelo
  • PGLite
  • Resend
  • Shadcn UI
  • Monaco Editor

🎯 ¿Para quién es?

  • Ingenieros de datos
  • Analistas de datos
  • Equipos de plataformas de bases de datos
  • Creadores de agentes que necesitan una capa de ejecución de bases de datos
  • Equipos de operaciones de ClickHouse

Tus datos siguen siendo tuyos. Excepto por las solicitudes de IA enviadas a través de Cloudflare Gateway, todo — conexiones, pestañas, resultados y consultas guardadas — se almacena localmente en tu dispositivo.

📄 Licencia

Apache-2.0