MotherDuck MCP Server

O que faz o servidor “MotherDuck” MCP?

O MotherDuck MCP Server é uma implementação do Model Context Protocol (MCP) que conecta assistentes de IA e IDEs aos bancos de dados DuckDB e MotherDuck. Ele permite que os usuários realizem análises SQL avançadas ao oferecer uma interface padronizada para consultas tanto em arquivos locais DuckDB quanto em bancos de dados MotherDuck na nuvem. O servidor suporta execução híbrida, permitindo acesso transparente a dados tanto de armazenamento local quanto em nuvem, incluindo Amazon S3 via integrações do MotherDuck. Ao expor a interação com o banco de dados como uma ferramenta para sistemas de IA, facilita para desenvolvedores e agentes de IA executar consultas, gerenciar dados e otimizar fluxos de trabalho sem configuração manual ou gerenciamento de servidores. Essa abordagem serverless acelera a análise, o compartilhamento de dados e o desenvolvimento de pipelines diretamente de ambientes potencializados por IA.

Lista de Prompts

• duckdb-motherduck-initial-prompt: Um template de prompt para inicializar uma conexão com o DuckDB ou MotherDuck e começar a trabalhar com o banco de dados.

Lista de Recursos

• Fechando o ciclo: Pipelines de Dados mais rápidos com MCP, DuckDB & IA (Blogpost): Post no blog cobrindo a integração do MCP, DuckDB e IA para desenvolvimento rápido de pipelines de dados.
• Desenvolvimento mais rápido de pipelines de dados com MCP e DuckDB (YouTube): Vídeo demonstrando o uso do MCP e DuckDB para pipelines de dados.

Lista de Ferramentas

• query: Executa uma consulta SQL em um banco de dados DuckDB ou MotherDuck.
  • Entradas:
    • query (string, obrigatório): A instrução SQL a ser executada.

Casos de Uso deste MCP Server

• Análise SQL em Assistentes de IA: Permite que LLMs ou assistentes de código executem consultas SQL diretamente no DuckDB ou MotherDuck, transformando instruções em linguagem natural em análises acionáveis.
• Desenvolvimento de Pipeline de Dados: Facilita o desenvolvimento e prototipagem rápidos de pipelines ao permitir que sistemas de IA interajam com fontes de dados locais e em nuvem.
• Consulta Híbrida Local & Nuvem: Suporta cenários em que desenvolvedores precisam consultar dados locais (DuckDB) e na nuvem (MotherDuck) sem atritos, aumentando a flexibilidade do fluxo de trabalho.
• Integração com Armazenamento em Nuvem: Agentes de IA podem acessar e analisar dados armazenados no Amazon S3 ou outros storages integrados à nuvem via conexões MotherDuck.
• Exploração de Dados Serverless: Elimina a necessidade de gerenciar infraestrutura de computação, permitindo análises rápidas e sob demanda para usuários e sistemas de IA.

Como configurar

Windsurf

1. Certifique-se de que você tem Node.js e Windsurf instalados.

2. Abra o arquivo de configuração do Windsurf (geralmente windsurf.config.json).

3. Adicione o MotherDuck MCP Server à seção mcpServers:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Salve a configuração e reinicie o Windsurf.

5. Verifique no Windsurf se o MotherDuck MCP Server está em execução e acessível.

Protegendo as Chaves de API

Use variáveis de ambiente para fornecer credenciais sensíveis como seu token MotherDuck:

{
  "mcpServers": {
    "motherduck": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"],
      "env": {
        "motherduck_token": "${MOTHERDUCK_TOKEN}"
      }
    }
  }
}

Claude

1. Instale o Claude e certifique-se de que o Node.js está configurado.

2. Localize o arquivo de configuração do Claude (normalmente claude.config.json).

3. Adicione o seguinte em mcpServers:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Reinicie o Claude e confirme se o servidor aparece na interface.

5. Use variáveis de ambiente como mostrado acima para proteger as chaves de API.

Cursor

1. Certifique-se de que o Cursor está instalado e atualizado.

2. Abra as configurações do Cursor (cursor.config.json).

3. Insira o seguinte em mcpServers:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Salve e reinicie o Cursor.

5. Defina tokens sensíveis via variáveis de ambiente.

Cline

1. Instale o Cline e as dependências necessárias.

2. Edite o cline.config.json para incluir:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

3. Salve o arquivo e reinicie o Cline.

4. Certifique-se de que o motherduck_token está definido como variável de ambiente para segurança.

Como usar este MCP em fluxos

Usando o MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "motherduck": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparaomcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de alterar "motherduck" para o nome real do seu servidor MCP e substituir a URL pela do seu servidor MCP.

Visão Geral

Entre essas duas tabelas, o MotherDuck MCP Server está bem documentado, com prompts claros, suporte a ferramentas, recursos e práticas de segurança, mas não menciona explicitamente Roots e suporte a Amostragem. No geral, é uma implementação sólida e prática para análise de bancos de dados com interface MCP.

Pontuação MCP