MotherDuck MCP
by MotherDuck
Consulta y analiza datos con MotherDuck serverless DuckDB y archivos locales vía SQL
database Python Intermedio Auto-hospedable Verificado
⭐ 150 stars 📅 Actualizado: hace 1m
Descripción
Servidor MCP para MotherDuck que permite a los LLMs consultar y analizar datos usando DuckDB serverless en la nube y bases de datos DuckDB locales. Combina sin problemas datos alojados en la nube con archivos locales — consulta archivos CSV, Parquet y JSON en tu máquina junto con tablas cloud en una sola sentencia SQL. Impulsado por el motor analítico ultrarrápido de DuckDB, soporta listar bases de datos, describir esquemas, ejecutar consultas y trabajar con archivos locales directamente. Perfecto para analistas de datos e ingenieros que quieren analytics asistido por IA sin mover datos entre sistemas.
✅ Ideal para
Analistas de datos que quieren consultar archivos locales y datos cloud juntos con asistencia de IA
⏭️ No recomendado si
Solo necesitas un conector de base de datos tradicional sin análisis de archivos locales
💡 Casos de uso
- Ejecutar analytics SQL sobre archivos locales CSV, Parquet y JSON mediante lenguaje natural
- Consultar bases de datos MotherDuck alojadas en la nube desde asistentes de IA
- Combinar datos locales y cloud en una sola consulta analítica
- Explorar y perfilar datasets sin escribir SQL manualmente
👍 Ventajas
- ✓ Consultas híbridas local + cloud — analiza archivos en disco junto con tablas cloud
- ✓ Construido sobre el motor analítico rápido de DuckDB con acceso zero-copy
- ✓ Arquitectura serverless — sin infraestructura que gestionar en el lado cloud
- ✓ Instalación simple vía pip o uvx con autenticación basada en token
👎 Desventajas
- ✗ Requiere una cuenta MotherDuck y token para funciones cloud
- ✗ El modo solo local tiene funcionalidad limitada comparado con el uso conectado a cloud
- ✗ Resultados grandes de consultas analíticas pueden consumir contexto significativo del LLM
🔧 Herramientas expuestas (4 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| list_databases | discovery | Listar todas las bases de datos disponibles en el workspace de MotherDuck |
| describe_table | discovery | Obtener el esquema y detalles de columnas de una tabla |
| execute_query | query | Ejecutar una consulta SQL contra MotherDuck o DuckDB local |
| query_local_files | query | Consultar archivos locales CSV, Parquet o JSON usando SQL |
⚡ Instalación
Requisitos previos:
- • python v3.10+
- • MotherDuck authentication token
- • API key requerida
Consulta la documentación de Claude Code para configurar este MCP server.
💡 Consejos y trucos
Configura la variable de entorno MOTHERDUCK_TOKEN para autenticación. Puedes consultar archivos locales directamente con SQL — prueba SELECT * FROM 'data.csv' LIMIT 10 para empezar. Usa la capacidad de consulta híbrida para unir archivos locales con tablas cloud sin problemas.
🔄 Alternativas
Info rápida
- Autor
- MotherDuck
- Licencia
- MIT
- Runtime
- Python 3.10+
- Transporte
- stdio
- Categoría
- database
- Dificultad
- Intermedio
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- —
- Versión
- latest
- Actualizado
- 28 feb 2026
Compatibilidad con clientes
- ✅ Claude Code
- ✅ Cursor
- ✅ VS Code Copilot
- ❓ Gemini CLI
- ✅ Windsurf
- ✅ Cline
- ❓ JetBrains AI
- ❓ Warp
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows