Servidor MCP de MotherDuck

Una implementación de servidor MCP que integra MotherDuck y DuckDB local, proporcionando capacidades de análisis SQL a Claude.

Características

• Ejecución híbrida : consulta datos tanto de MotherDuck basado en la nube como de DuckDB local
• Integración de almacenamiento en la nube : acceda a los datos almacenados en Amazon S3 u otro almacenamiento en la nube gracias a las integraciones de MotherDuck
• Intercambio de datos : crear y compartir bases de datos
• Análisis SQL : utilice el dialecto SQL de DuckDB para consultar cualquier tamaño de datos directamente desde Claude
• Arquitectura sin servidor : ejecute análisis sin necesidad de configurar instancias o clústeres

Componentes

Indicaciones

El servidor proporciona un mensaje:

• duckdb-motherduck-initial-prompt : un mensaje para inicializar una conexión a DuckDB o MotherDuck y comenzar a trabajar con él

Herramientas

El servidor ofrece una herramienta:

• query : Ejecutar una consulta SQL en la base de datos MotherDuck/DuckDB
  • Entradas :
    • query (cadena, obligatoria): La consulta SQL a ejecutar

Todas las interacciones con DuckDB y MotherDuck se realizan mediante la escritura de consultas SQL.

Empezando

Prerrequisitos

• Una cuenta MotherDuck (regístrese en motherduck.com )
• Un token de acceso de MotherDuck
• uv instalado, puedes instalarlo usando pip install uv o brew install uv

Si planea utilizar MotherDuck MCP con Claude Desktop, también necesitará tener Claude Desktop instalado.

Configurando su token MotherDuck

1. Regístrese para obtener una cuenta de MotherDuck
2. Generar un token de acceso a través de la interfaz de usuario de MotherDuck
3. Almacene el token de forma segura para usarlo en la configuración

Uso con Claude Desktop

1. Instale Claude Desktop desde claude.ai/download si aún no lo ha hecho
2. Abra el archivo de configuración de Claude Desktop:

• Para acceder rápidamente o crearlo por primera vez, abra la aplicación Claude Desktop, seleccione Configuración y haga clic en la pestaña "Desarrollador", finalmente haga clic en el botón "Editar configuración".
• Agregue la siguiente configuración a su claude_desktop_config.json :

Notas importantes :

• Reemplace YOUR_MOTHERDUCK_TOKEN_HERE con su token MotherDuck real
• Reemplace YOUR_HOME_FOLDER_PATH con la ruta a su directorio personal (necesaria para DuckDB para las operaciones con archivos). Por ejemplo, en macOS, sería /Users/your_username
• La variable de entorno HOME es necesaria para que DuckDB funcione correctamente.

Consultas de ejemplo

Una vez configurado, puedes pedirle a Claude que ejecute consultas como:

• "Crear una nueva base de datos y tabla en MotherDuck"
• Consultar datos de mi archivo CSV local
• Unir datos de mi base de datos local DuckDB con una tabla en MotherDuck
• Analizar datos almacenados en Amazon S3

Pruebas

El servidor está diseñado para ejecutarse con herramientas como Claude Desktop y Cursor, pero puede iniciarlo manualmente para realizar pruebas. Al probar el servidor manualmente, puede especificar la base de datos a la que conectarse mediante el parámetro --db-path :

1. Base de datos MotherDuck predeterminada :
   • Para conectarse a la base de datos MotherDuck predeterminada, deberá pasar el token de autenticación mediante el parámetro --motherduck-token .
   uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>
2. Base de datos específica de MotherDuck :
   uvx mcp-server-motherduck --db-path md:your_database_name --motherduck-token <your_motherduck_token>
3. Base de datos local de DuckDB :
   uvx mcp-server-motherduck --db-path /path/to/your/local.db
4. Base de datos en memoria :
   uvx mcp-server-motherduck --db-path :memory:

Si no especifica una ruta de base de datos pero ha configurado la variable de entorno motherduck_token , el servidor se conectará automáticamente a la base de datos MotherDuck predeterminada ( md: ).

Ejecutando en modo SSE

El servidor también podría ejecutarse en modo SSE usando supergateway ejecutando el siguiente comando:

Además, puede apuntar a sus clientes, como Claude Desktop o Cursor, a este punto final.

Solución de problemas

• Si tiene problemas de conexión, verifique que su token MotherDuck sea correcto
• Para problemas de acceso a archivos locales, asegúrese de que el parámetro --home-dir esté configurado correctamente
• Verifique que el comando uvx esté disponible en su PATH
• Si encuentra errores spawn uvx ENOENT , intente especificar la ruta completa a uvx ( which uvx )
• En la versión anterior v0.4.0 usábamos variables de entorno, ahora usamos parámetros

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.