# MotherDuck MCP Server

> Ejecuta consultas SQL con el motor analítico de DuckDB contra bases locales, archivos en S3 o MotherDuck en la nube desde tu asistente de IA.

Fuente: https://skillsagentes.com/mcp/motherduck
Markdown: https://skillsagentes.com/mcp/motherduck.md

Repositorio: https://github.com/motherduckdb/mcp-server-motherduck
Autor: motherduckdb
Licencia: MIT
Estrellas: 523
Último push: 19 sept 2026
Transporte: stdio, http
Publicado por el proveedor del producto.

## Qué es

Este servidor MCP conecta asistentes de IA al motor analítico de DuckDB, permitiendo trabajar con bases de datos locales, en memoria, archivos alojados en S3 o con MotherDuck (el servicio en la nube basado en DuckDB). El agente puede ejecutar consultas SQL de lectura y escritura, explorar el catálogo de bases de datos, tablas y columnas, y cambiar de conexión sobre la marcha si se habilita esa opción.

Por defecto el servidor arranca en modo solo lectura; para permitir escrituras hay que añadir --read-write. La base de datos se especifica con --db-path, aceptando :memory:, una ruta local absoluta, md: para MotherDuck o una URL s3://. Para conectarse a MotherDuck se necesita un token vía la variable motherduck_token o MOTHERDUCK_TOKEN.

Se instala y ejecuta con uvx mcp-server-motherduck, y también puede levantarse con Docker exponiendo Streamable HTTP en el puerto 8000. Los resultados de las consultas se limitan por defecto a 1024 filas o 50.000 caracteres, ajustable con --max-rows y --max-chars, e incluye protecciones adicionales como --init-sql y modo SaaS de MotherDuck para restringir el acceso al sistema de archivos local en despliegues de producción.

Es compatible con Claude Desktop, Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code y Kiro, entre otros clientes MCP.

## Instalación

```bash
uvx mcp-server-motherduck
```

## Qué hace

- Ejecuta consultas SQL de lectura y escritura con el dialecto de DuckDB
- Lista bases de datos, tablas, vistas y columnas del catálogo conectado
- Permite cambiar de conexión entre bases locales, S3 y MotherDuck en tiempo de ejecución
- Soporta conexión a archivos DuckDB locales, en memoria, en S3 o al servicio MotherDuck
- Aplica límites configurables de filas y caracteres devueltos, y timeout de consultas

## Cuándo usarlo

- Cuando quieres que un asistente de IA analice o consulte datos usando SQL sobre DuckDB o MotherDuck
- Cuando necesitas exponer archivos DuckDB locales o en S3 a un agente sin montar infraestructura adicional
- Cuando trabajas en un IDE o cliente MCP y quieres alternar entre distintas bases de datos durante la sesión
- Cuando necesitas un despliegue autoalojado, en lugar del MCP remoto totalmente gestionado por MotherDuck

## Herramientas que expone

- `execute_query`
- `list_databases`
- `list_tables`
- `list_columns`
- `switch_database_connection`

## Credenciales que pide

- `MOTHERDUCK_TOKEN`
- `AWS_ACCESS_KEY_ID`
- `AWS_SECRET_ACCESS_KEY`
- `AWS_SESSION_TOKEN`
- `AWS_DEFAULT_REGION`
- `AWS_ENDPOINT`
- `HOME`

## Dónde encaja

- Categoría: [Bases de datos](https://skillsagentes.com/mcp/categorias/bases-de-datos.md) — Diseño de esquemas, migraciones y optimización de consultas.
- [Todos los servidores MCP](https://skillsagentes.com/mcp.md)
- [Agent Skills](https://skillsagentes.com/skills.md)

## Servidores relacionados

- [Graphiti](https://skillsagentes.com/mcp/graphiti.md): Conecta agentes de IA a Graphiti, un motor de grafos de contexto temporal, para que puedan guardar y consultar hechos que cambian con el tiempo.
- [MCP Toolbox for Databases](https://skillsagentes.com/mcp/mcp-toolbox-for-databases.md): Conecta agentes de IA a bases de datos empresariales (PostgreSQL, MySQL, BigQuery, Spanner, MongoDB, Redis y más) con herramientas listas o personalizadas.
- [Convex](https://skillsagentes.com/mcp/convex.md): Conecta con Convex, la base de datos reactiva de código abierto, para consultar datos y ejecutar lógica de negocio con consistencia fuerte desde funciones TypeScript.
- [LanceDB](https://skillsagentes.com/mcp/lancedb.md): Conecta al agente con LanceDB, una base de datos vectorial embebida para búsqueda multimodal, permitiendo consultas por vector, texto completo o SQL sobre datos locales o en la nube.
- [GreptimeDB](https://skillsagentes.com/mcp/greptimedb.md): Conecta al agente con GreptimeDB, una base de datos unificada para métricas, logs y trazas que se consulta con SQL y PromQL sobre almacenamiento de objetos.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)