Configuração do MCP Server

O DataSpoc expõe servidores MCP (Model Context Protocol) tanto para o Lens quanto para o Pipe. Isso permite que assistentes de IA descubram tabelas, executem queries, gerenciem pipelines e mais --- diretamente da conversa.

MCP Server do Lens

Instalar

pip install dataspoc-lens[mcp]

Executar

dataspoc-lens mcp

Configuração no Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "dataspoc-lens": {
      "command": "dataspoc-lens",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Tools Disponíveis

Tool	Descrição
list_tables	Lista todas as tabelas no data lake
describe_table	Mostra schema, contagem de linhas e partições de uma tabela
query	Executa uma query SQL e retorna resultados
ask	Faz uma pergunta em linguagem natural sobre os dados
cache_status	Mostra frescor e tamanho do cache
cache_refresh	Atualiza todos os dados cacheados do bucket
cache_refresh_stale	Atualiza apenas tabelas com cache desatualizado

Resources Disponíveis

Resource	Descrição
lens://tables	Catálogo completo com schemas e metadados

MCP Server do Pipe

Instalar

pip install dataspoc-pipe[mcp]

Executar

dataspoc-pipe mcp

Configuração no Claude Desktop

{
  "mcpServers": {
    "dataspoc-pipe": {
      "command": "dataspoc-pipe",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Tools Disponíveis

Tool	Descrição
list_pipelines	Lista todos os pipelines configurados
pipeline_config	Mostra a configuração de um pipeline
run_pipeline	Executa um pipeline
pipeline_status	Verifica status de execução e último sync
pipeline_logs	Mostra logs de execução
show_manifest	Lê o manifest do bucket
validate_pipeline	Valida a configuração do pipeline

Resources Disponíveis

Resource	Descrição
pipe://pipelines	Catálogo completo de pipelines com configurações

Usando Ambos os Servidores Juntos

Você pode rodar ambos os servidores MCP simultaneamente. Adicione os dois ao config do Claude Desktop:

{
  "mcpServers": {
    "dataspoc-lens": {
      "command": "dataspoc-lens",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    },
    "dataspoc-pipe": {
      "command": "dataspoc-pipe",
      "args": ["mcp"],
      "env": {
        "DATASPOC_BUCKET": "s3://my-data"
      }
    }
  }
}

Isso dá ao agente controle total: ingerir novos dados com o Pipe e depois consultá-los com o Lens --- tudo em uma única conversa.

Cursor e Windsurf

Tanto o Cursor quanto o Windsurf suportam servidores MCP. Adicione a mesma configuração nos respectivos arquivos de configuração. Consulte a documentação do Cursor ou Windsurf para o local exato do arquivo de config.