Data Exploration

Servidor MCP para exploração autônoma de dados em conjuntos de dados baseados em .csv, fornecendo insights inteligentes com esforço mínimo.

GitHub
544
Experimente este MCPPatrocinado

Documentação

MCP Server para Data Exploration

O MCP Server é uma ferramenta versátil projetada para exploração interativa de dados.

Seu assistente pessoal de ciência de dados, transformando conjuntos de dados complexos em insights claros e acionáveis.

mcp-server-data-exploration MCP server

🚀 Experimente

  1. Baixe o Claude Desktop

  2. Instale e Configure

    • No macOS, execute o seguinte comando no seu terminal:
    python setup.py

  3. Carregue Templates e Ferramentas

    • Assim que o servidor estiver em execução, aguarde o template de prompt e as ferramentas carregarem no Claude Desktop.

  4. Comece a Explorar

    • Selecione o template de prompt explore-data do MCP
    • Inicie sua conversa fornecendo as entradas necessárias:
      • csv_path: Caminho local para o arquivo CSV
      • topic: O tópico da exploração (ex.: "Padrões climáticos em Nova York" ou "Preços de imóveis na Califórnia")

Exemplos

Estes são exemplos de como você pode usar o MCP Server para explorar dados sem qualquer intervenção humana.

Caso 1: Preços de Listagem de Imóveis na Califórnia

  • Conjunto de Dados Kaggle: USA Real Estate Dataset
  • Tamanho: 2.226.382 entradas (178,9 MB)
  • Tópico: Tendências de preços de imóveis na Califórnia

Watch the video

Caso 2: Clima em Londres

📦 Componentes

Prompts

  • explore-data: Adaptado para tarefas de exploração de dados

Ferramentas

  1. load-csv

    • Função: Carrega um arquivo CSV em um DataFrame
    • Argumentos:
      • csv_path (string, obrigatório): Caminho para o arquivo CSV
      • df_name (string, opcional): Nome para o DataFrame. Padrão: df_1, df_2, etc., se não for fornecido

  2. run-script

    • Função: Executa um script Python
    • Argumentos:
      • script (string, obrigatório): O script a ser executado

⚙️ Modificando o Servidor

Configurações do Claude Desktop

  • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Desenvolvimento (Servidores Não Publicados)

"mcpServers": {
  "mcp-server-ds": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/username/src/mcp-server-ds",
      "run",
      "mcp-server-ds"
    ]
  }
}

Servidores Publicados

"mcpServers": {
  "mcp-server-ds": {
    "command": "uvx",
    "args": [
      "mcp-server-ds"
    ]
  }
}

🛠️ Desenvolvimento

Construção e Publicação

  1. Sincronizar Dependências

    uv sync

  2. Construir Distribuições

    uv build

    Gera distribuições de código-fonte e wheel no diretório dist/.

  3. Publicar no PyPI

    uv publish

🤝 Contribuindo

Contribuições são bem-vindas! Seja corrigindo bugs, adicionando recursos ou melhorando a documentação, sua ajuda torna este projeto melhor.

Reportando Problemas

Se você encontrar bugs ou tiver sugestões, abra uma issue na seção de issues. Inclua:

  • Passos para reproduzir (se aplicável)
  • Comportamento esperado vs. real
  • Capturas de tela ou logs de erro (se relevante)

📜 Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

💬 Entre em Contato

Dúvidas? Feedback? Abra uma issue ou entre em contato com os mantenedores. Vamos tornar este projeto incrível juntos!

Sobre

Este é um projeto de código aberto mantido pela ReadingPlus.AI LLC e aberto a contribuições de toda a comunidade.