Gemini Data Analysis Research MCP Server

🚀 GEMINI Data Analysis Platform

The GEMINI Data Analysis Platform offers a comprehensive suite of tools for data analysis, research, and in - depth thinking generation. It simplifies complex tasks and enhances productivity through its powerful features and user - friendly interfaces.

🚀 Quick Start

Installation and Running

1. Clone the repository

   git clone your_repository.git
   

2. Install dependencies

   npm install
   

3. Start the service

   npm run start
   

✨ Features

1. Gemini Data Analysis Tool

• Function Description: Offers powerful data analysis and report - generation capabilities, supporting multiple data file formats.
• Supported File Types: .xlsx, .xls, .csv

2. Research and Email Sending System

• Email Sending Function: Supports intelligent email subject generation, text content writing, and HTML - format email creation based on Gemini AI.
• Attachment Management: Allows adding and embedding images in emails.

3. Thinking Generator Tool

• AI - Driven Thinking: Utilizes the Gemini model to analyze complex problems and outputs in - depth thinking process documents.

💻 Usage Examples

Basic Usage

Data Analysis Tool Interface Definition

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 Definition

interface SendEmailParams {
  to: string;              // Recipient's email address
  subjectPrompt: string;   // Prompt for Gemini to generate the email subject
  text: string;            // Plain - text version of the email content
  html?: string;           // Optional HTML - format email content
  images?: {               // Optional image attachments
    name: string;          // Image file name
    data: string;          // Base64 - encoded image data
  }[];
}

Thinking Generator Tool Interface Definition

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

📚 Documentation

Output Structure

Data Analysis Module Output Example

• File Name: report_[DateTime].html
• Location: ./output/reports/

Thinking Generator Module Output Example

• File Name: gemini_thinking_[DateTime].txt
• Location: ./output/thinking/

Development Information

Available Script Commands

1. npm run build: Compile TypeScript code to JavaScript.
2. npm run start: Start the MCP service.
3. npm run dev: Run in development mode (using ts - node).

Environment Variable Configuration

• GEMINI_API_KEY: Your Google Gemini API key.
• NODEMAILER_EMAIL: Your email address.
• NODEMAILER_PASSWORD: Your email application password.

Troubleshooting

Common Issues

1. API Key Error

   • Confirm that the .env file exists and is configured correctly.
   • Verify the validity of the key.
   • Check if the environment variables are loaded successfully.

2. Claude Desktop Connection Issue

   • Check the syntax of the config.json file.
   • Confirm that the file path is correct.
   • Restart the Claude Desktop application.

3. Email Sending Failure

   • Check if the email address format is correct.
   • Ensure a stable network connection.
   • Verify the accuracy of the SMTP configuration parameters.

📄 License

⚠️ Important Note

Ensure the security of your API key and avoid disclosure.

⚠️ Important Note

Do not share the .env file containing sensitive information.

⚠️ Important Note

When using a Google account, use an application password instead of the main password.

Contact Information

• Developer Email: your.email@example.com
• Project Repository Link: https://github.com/yourusername/yourrepository

⚠️ Important Note

Please carefully read and comply with relevant laws, regulations, and service terms before using this platform.