Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Gemini MCP Image Generation Server
  • MCP Server for Deep Research
  • MCP Web Browser Server
  • Vertex AI MCP Server
  • mcp-server-data-exploration
Back to MCP Servers
Gemini Data Analysis  Research MCP Server

Gemini Data Analysis Research MCP Server

Public
falahgs/Gemini-Data-Analysis-Research-MCP-Server

Leverages Google's Gemini Flash 2 AI via Model Context Protocol to perform advanced data analysis, generate professional research papers and reports, and automate secure email delivery with customizable content and interactive visualizations.

typescript
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with Gemini Data Analysis Research MCP Server

MCP Server

Unlock the full potential of Gemini Data Analysis Research MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Gemini Data Analysis & Research MCP Server

A powerful Model Context Protocol (MCP) server that leverages Google's Gemini Flash 2 AI model for comprehensive data analysis, research paper generation, and automated email delivery. This server provides an integrated solution for analyzing datasets, generating research content, and distributing results directly to stakeholders via email.

🚀 Features

1. Advanced Data Analysis & Reporting (analyze-data)

  • Comprehensive analysis of Excel (.xlsx, .xls) and CSV files
  • Features:
    • Automatic data type detection and parsing
    • Statistical analysis of numeric columns
    • Interactive visualizations using Chart.js
    • AI-powered insights using Gemini Flash 2
    • Detailed HTML reports with interactive plots
    • Direct email delivery of analysis results
    • Basic and detailed analysis modes
    • Customizable output directory
    • Support for large datasets
    • Automatic outlier detection
    • Correlation analysis for numeric columns

2. Research & Email Delivery System (send-email)

  • Professional research paper generation and distribution
  • Features:
    • AI-powered research paper generation
    • Automated email delivery of analysis results
    • Support for multiple content types:
      • Research papers
      • Technical reports
      • Data analysis summaries
      • Business intelligence reports
    • Professional email subject line generation
    • Support for both HTML and plain text content
    • Image attachments with inline display capability
    • Secure SMTP authentication
    • Comprehensive error handling and status reporting
    • Professional email formatting
    • Message delivery tracking
    • Customizable email templates

3. Research & Analysis Generator (generate-thinking)

  • Advanced research and analysis generation
  • Features:
    • Research paper generation
    • Technical documentation writing
    • Data analysis summaries
    • Business intelligence reports
    • Timestamped response saving
    • Customizable output directory
    • Direct email delivery of generated content
    • Professional content creation

📊 Quick Start

Prerequisites

  • Node.js (v16 or higher)
  • TypeScript
  • Claude Desktop
  • Google Gemini API Key
  • SMTP Email Account (for email functionality)

Installation

  1. Clone and setup:
git clone [your-repo-url] cd gemini-data-analysis-email-generator npm install
  1. Create .env file:
GEMINI_API_KEY=your_api_key_here NODEMAILER_EMAIL=your.email@gmail.com NODEMAILER_PASSWORD=your_app_password_here
  1. Build the project:
npm run build

Claude Desktop Configuration

  1. Create/Edit %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. Restart Claude Desktop

📊 Using the Tools

Data Analysis with EDA and AI

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

Email Sending with AI Subject Generation

{ "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": "Hello!This is the HTML version of our email.", "images": [ { "name": "chart.png", "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." } ] } }

Thinking Generation

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

📁 Output Structure

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

🛠️ Development

Available Scripts

  • npm run build: Compile TypeScript to JavaScript
  • npm run start: Start the MCP server
  • npm run dev: Run in development mode with ts-node

Environment Variables

  • GEMINI_API_KEY: Your Google Gemini API key
  • NODEMAILER_EMAIL: Your email address for sending emails
  • NODEMAILER_PASSWORD: Your email app password (for Gmail, use an app password)

🔒 Security Notes

  • Store your API keys securely
  • Don't share your .env file
  • For Gmail, use app passwords instead of your main account password
  • Be careful with the content of emails sent through the system
  • Never include sensitive or personal information in email examples

🐛 Troubleshooting

Common Issues

  1. API Key Error

    • Verify .env file exists
    • Check API key validity
    • Ensure proper environment loading
  2. Claude Desktop Connection

    • Verify config.json syntax
    • Check file paths in config
    • Restart Claude Desktop
  3. Email Sending Issues

    • Check that NODEMAILER_EMAIL and NODEMAILER_PASSWORD are set correctly
    • For Gmail, ensure you've created an app password
    • Verify that less secure app access is enabled for non-Gmail providers
    • Check recipient email address format
  4. Data Analysis Issues

    • Ensure file format is supported (.xlsx, .xls, .csv)
    • Check file encoding (UTF-8 recommended)
    • Verify file size is within limits
    • Ensure numeric columns are properly formatted

Debug Mode

Add DEBUG=true to your .env file for verbose logging:

GEMINI_API_KEY=your_key_here DEBUG=true

📚 API Reference

Data Analysis Tool

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 }

Email Sending Tool

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 }[]; }

Thinking Generation Tool

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

👨‍💻 Author

Falah G. Salieh
📍 Baghdad, Iraq
📅 2025

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

📄 License

MIT License - See LICENSE file for details

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Gemini MCP Image Generation Server
    Gemini MCP Image Generation Server

    Provides image generation capabilities via Google's Gemini 2 API using the Model Context Protocol, e...

    1 tools
    Added May 30, 2025
  • MCP Server for Deep Research
    MCP Server for Deep Research

    Conduct comprehensive, structured research with a Model Context Protocol server that elaborates ques...

    Added May 30, 2025
  • MCP Web Browser Server
    MCP Web Browser Server

    Advanced Model Context Protocol server enabling headless web browsing with multi-tab support, dynami...

    6 tools
    Added May 30, 2025
  • Vertex AI MCP Server
    Vertex AI MCP Server

    Provides a Model Context Protocol server enabling advanced interaction with Google Cloud's Vertex AI...

    20 tools
    Added May 30, 2025
  • mcp-server-data-exploration
    mcp-server-data-exploration

    Interactive Model Context Protocol server enabling seamless data exploration by loading CSV datasets...

    2 tools
    Added May 30, 2025