Gemini Data Analysis & Research

Utiliza o Google Gemini AI para análise de dados, geração de artigos de pesquisa e entrega automatizada de e-mails.

GitHub
4
Experimente este MCPPatrocinado

Documentação

Gemini Data Analysis & Research MCP Server

Um poderoso servidor Model Context Protocol (MCP) que aproveita o modelo de IA Gemini Flash 2 do Google para análise abrangente de dados, geração de artigos de pesquisa e entrega automatizada de e-mails. Este servidor fornece uma solução integrada para analisar conjuntos de dados, gerar conteúdo de pesquisa e distribuir resultados diretamente às partes interessadas por e-mail.

🚀 Recursos

1. Análise Avançada de Dados e Relatórios (analyze-data)

  • Análise abrangente de arquivos Excel (.xlsx, .xls) e CSV
  • Recursos:
    • Detecção e análise automática de tipos de dados
    • Análise estatística de colunas numéricas
    • Visualizações interativas usando Chart.js
    • Insights alimentados por IA usando Gemini Flash 2
    • Relatórios HTML detalhados com gráficos interativos
    • Entrega direta por e-mail dos resultados da análise
    • Modos de análise básica e detalhada
    • Diretório de saída personalizável
    • Suporte para grandes conjuntos de dados
    • Detecção automática de outliers
    • Análise de correlação para colunas numéricas

2. Sistema de Pesquisa e Entrega por E-mail (send-email)

  • Geração e distribuição profissional de artigos de pesquisa
  • Recursos:
    • Geração de artigos de pesquisa alimentada por IA
    • Entrega automatizada por e-mail dos resultados da análise
    • Suporte para múltiplos tipos de conteúdo:
      • Artigos de pesquisa
      • Relatórios técnicos
      • Resumos de análise de dados
      • Relatórios de inteligência de negócios
    • Geração profissional de linhas de assunto de e-mail
    • Suporte para conteúdo em HTML e texto simples
    • Anexos de imagem com capacidade de exibição inline
    • Autenticação SMTP segura
    • Tratamento abrangente de erros e relatórios de status
    • Formatação profissional de e-mail
    • Rastreamento de entrega de mensagens
    • Modelos de e-mail personalizáveis

3. Gerador de Pesquisa e Análise (generate-thinking)

  • Geração avançada de pesquisa e análise
  • Recursos:
    • Geração de artigos de pesquisa
    • Redação de documentação técnica
    • Resumos de análise de dados
    • Relatórios de inteligência de negócios
    • Salvamento de respostas com carimbo de data/hora
    • Diretório de saída personalizável
    • Entrega direta por e-mail do conteúdo gerado
    • Criação profissional de conteúdo

📊 Início Rápido

Pré-requisitos

  • Node.js (v16 ou superior)
  • TypeScript
  • Claude Desktop
  • Chave de API do Google Gemini
  • Conta de e-mail SMTP (para funcionalidade de e-mail)

Instalação

  1. Clone e configure:
git clone [your-repo-url]
cd gemini-data-analysis-email-generator
npm install
  1. Crie o arquivo .env:
GEMINI_API_KEY=your_api_key_here
NODEMAILER_EMAIL=your.email@gmail.com
NODEMAILER_PASSWORD=your_app_password_here
  1. Compile o projeto:
npm run build

Configuração do Claude Desktop

  1. Crie/Edite %AppData%/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "Gemini Data Analysis": {
      "command": "node",
      "args": ["path/to/gemini-data-analysis-email-generator/dist/index.js"],
      "cwd": "path/to/gemini-data-analysis-email-generator",
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "NODEMAILER_EMAIL": "your.email@gmail.com",
        "NODEMAILER_PASSWORD": "your_app_password_here"
      }
    }
  }
}
  1. Reinicie o Claude Desktop

📊 Usando as Ferramentas

Análise de Dados com EDA e IA

{
  "name": "analyze-data",
  "arguments": {
    "fileData": "base64_encoded_file_content",
    "fileName": "data.xlsx",
    "analysisType": "detailed",
    "outputDir": "./analysis_results"
  }
}

Envio de E-mail com Geração de Assunto por IA

{
  "name": "send-email",
  "arguments": {
    "to": "recipient@example.com",
    "subjectPrompt": "Create a professional subject line for a business report",
    "text": "Hello! This is the plain text version of our email.",
    "html": "<h1>Hello!</h1><p>This is the <b>HTML</b> version of our email.</p>",
    "images": [
      {
        "name": "chart.png",
        "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      }
    ]
  }
}

Geração de Pensamento

{
  "name": "generate-thinking",
  "arguments": {
    "prompt": "Analyze the market trends for Q1 2024",
    "outputDir": "./thinking_output"
  }
}

📁 Estrutura de Saída

output/
├── analysis/
│   ├── plots/
│   │   ├── column1_histogram_[timestamp].html
│   │   └── column2_histogram_[timestamp].html
│   ├── analysis_[timestamp].txt
│   └── report_[timestamp].html
├── thinking/
│   └── gemini_thinking_[timestamp].txt
└── emails/
    └── email_log_[timestamp].txt

🛠️ Desenvolvimento

Scripts Disponíveis

  • npm run build: Compilar TypeScript para JavaScript
  • npm run start: Iniciar o servidor MCP
  • npm run dev: Executar em modo de desenvolvimento com ts-node

Variáveis de Ambiente

  • GEMINI_API_KEY: Sua chave de API do Google Gemini
  • NODEMAILER_EMAIL: Seu endereço de e-mail para envio de mensagens
  • NODEMAILER_PASSWORD: Sua senha de aplicativo de e-mail (para Gmail, use uma senha de aplicativo)

🔒 Notas de Segurança

  • Armazene suas chaves de API com segurança
  • Não compartilhe seu arquivo .env
  • Para Gmail, use senhas de aplicativo em vez da senha principal da conta
  • Tenha cuidado com o conteúdo dos e-mails enviados pelo sistema
  • Nunca inclua informações sensíveis ou pessoais em exemplos de e-mail

🐛 Solução de Problemas

Problemas Comuns

  1. Erro de Chave de API

    • Verifique se o arquivo .env existe
    • Verifique a validade da chave de API
    • Garanta o carregamento adequado das variáveis de ambiente

  2. Conexão com o Claude Desktop

    • Verifique a sintaxe do config.json
    • Verifique os caminhos dos arquivos na configuração
    • Reinicie o Claude Desktop

  3. Problemas no Envio de E-mail

    • Verifique se NODEMAILER_EMAIL e NODEMAILER_PASSWORD estão configurados corretamente
    • Para Gmail, certifique-se de ter criado uma senha de aplicativo
    • Verifique se o acesso a aplicativos menos seguros está habilitado para provedores que não sejam Gmail
    • Verifique o formato do endereço de e-mail do destinatário

  4. Problemas na Análise de Dados

    • Garanta que o formato do arquivo seja suportado (.xlsx, .xls, .csv)
    • Verifique a codificação do arquivo (UTF-8 recomendado)
    • Verifique se o tamanho do arquivo está dentro dos limites
    • Garanta que as colunas numéricas estejam formatadas corretamente

Modo de Depuração

Adicione DEBUG=true ao seu arquivo .env para registro detalhado:

GEMINI_API_KEY=your_key_here
DEBUG=true

📚 Referência da API

Ferramenta de Análise de Dados

interface AnalyzeDataParams {
  fileData: string;         // Base64 encoded file content
  fileName: string;         // File name (must be .xlsx, .xls, or .csv)
  analysisType: 'basic' | 'detailed';  // Analysis type
  outputDir?: string;      // Optional output directory
}

Ferramenta de Envio de E-mail

interface SendEmailParams {
  to: string;              // Recipient email address
  subjectPrompt: string;   // Prompt for Gemini to generate email subject
  text: string;            // Plain text version of email
  html?: string;           // HTML version of email (optional)
  images?: {               // Optional images to attach
    name: string;          // Image filename
    data: string;          // Base64 encoded image data
  }[];
}

Ferramenta de Geração de Pensamento

interface GenerateThinkingParams {
  prompt: string;           // Analysis prompt
  outputDir?: string;       // Optional output directory
}

👨‍💻 Autor

Falah G. Salieh
📍 Bagdá, Iraque
📅 2025

🤝 Contribuindo

  1. Faça um fork do repositório
  2. Crie sua branch de recurso
  3. Faça commit das suas alterações
  4. Envie para a branch
  5. Crie um Pull Request

📄 Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes