Gemini Data Analysis & Research MCP

Gemini数据分析与研究MCP服务器

一个强大的模型上下文协议（MCP）服务器，利用谷歌的Gemini Flash 2 AI模型进行全面的数据分析、研究论文生成和自动电子邮件传递。该服务器为分析数据集、生成研究内容以及通过电子邮件直接向利益相关者分发结果提供了一个集成解决方案。

🚀 特性

1.高级数据分析和报告(analyze-data)

• Excel（.xlsx、.xls）和CSV文件的综合分析
• 特征：

- 自动数据类型检测和解析 - 数字列的统计分析 - 使用Chart.js的交互式可视化 - 使用Gemini Flash 2的人工智能洞察力 - 带有交互式绘图的详细HTML报告 - 直接通过电子邮件发送分析结果 - 基本和详细分析模式 - 可定制的输出目录 - 支持大型数据集 - 自动异常检测 - 数值列的相关性分析

2.研究和电子邮件传递系统(send-email)

• 专业研究论文的生成和分发
• 特征：

- 人工智能驱动的研究论文生成 - 自动通过电子邮件发送分析结果 - 支持多种内容类型： - 研究论文 - 技术报告 - 数据分析总结 - 商业智能报告 - 专业电子邮件主题行生成 - 支持HTML和纯文本内容 - 具有内联显示功能的图像附件 - 安全SMTP身份验证 - 全面的错误处理和状态报告 - 专业电子邮件格式 - 邮件传递跟踪 - 可定制的电子邮件模板

3.研究与分析生成器(generate-thinking)

• 高级研究和分析生成
• 特征：

- 研究论文生成 - 技术文件编写 - 数据分析总结 - 商业智能报告 - 带时间戳的响应保存 - 可定制的输出目录 - 直接通过电子邮件发送生成的内容 - 专业内容创作

📊 快速开始

先决条件

• Node.js（v16或更高版本）
• TypeScript
• 克劳德桌面
• Google Gemini API密钥
• SMTP电子邮件帐户（用于电子邮件功能）

安装

1. 克隆和设置：

git clone [your-repo-url]
cd gemini-data-analysis-email-generator
npm install

1. 创建 .env 文件：

GEMINI_API_KEY=your_api_key_here
NODEMAILER_EMAIL=your.email@gmail.com
NODEMAILER_PASSWORD=your_app_password_here

1. 构建项目：

npm run build

Claude桌面配置

1. 创建/编辑 %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. 重新启动克劳德桌面

📊 使用工具

基于EDA和AI的数据分析

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

使用人工智能生成主题的电子邮件发送

{
  "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..."
      }
    ]
  }
}

思维生成

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

📁 输出结构

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

🛠️ 发展

可用脚本

• npm run build：将TypeScript编译为JavaScript
• npm run start：启动MCP服务器
• npm run dev：使用ts节点在开发模式下运行

环境变量

• GEMINI_API_KEY：您的Google Gemini API密钥
• NODEMAILER_EMAIL：用于发送电子邮件的电子邮件地址
• NODEMAILER_PASSWORD：您的电子邮件应用程序密码（对于Gmail，请使用应用程序密码）

🔒 安全说明

• 安全地存储API密钥
• 不要分享你的 .env 文件
• 对于Gmail，使用应用程序密码而不是主帐户密码
• 小心通过系统发送的电子邮件内容
• 切勿在电子邮件示例中包含敏感或个人信息

🐛 故障排除

常见问题

1. API密钥错误

- 验证 .env 文件存在 - 检查API密钥的有效性 - 确保适当的环境负载

1. Claude桌面连接

- 验证config.json语法 - 检查配置中的文件路径 - 重新启动克劳德桌面

1. 电子邮件发送问题

- 检查NODEMAILER_EMAIL和NODEMAILER_PASSWORD是否设置正确 - 对于Gmail，请确保您已创建应用程序密码 - 验证是否为非Gmail提供商启用了不太安全的应用程序访问 - 检查收件人电子邮件地址格式

1. 数据分析问题

- 确保支持文件格式（.xlsx、.xls、.csv） - 检查文件编码（建议使用UTF-8） - 验证文件大小是否在限制范围内 - 确保数字列的格式正确

调试模式

添加 DEBUG=true 到你的 .env 详细日志记录文件：

GEMINI_API_KEY=your_key_here
DEBUG=true

📚 api参考

数据分析工具

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
}

电子邮件发送工具

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

思维生成工具

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

👨‍💻 作者

法拉·萨利赫\ 📍 伊拉克巴格达\ 📅 2025

🤝 贡献

1. 分叉存储库
2. 创建功能分支
3. 提交您的更改
4. 推到分支
5. 创建拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件