Gemini Data Analysis & Research MCP Server

Gemini 数据分析与研究 MCP 服务

一款功能强大的模型上下文协议（MCP）服务，利用 Google Gemini Flash 2 AI 模型进行全面的数据分析、研究论文生成和自动邮件发送。该服务提供一体化解决方案，可分析数据集、生成研究内容，并通过邮件将结果直接发送给相关人员。

🚀 功能

1. 高级数据分析与报告（analyze-data）

• 全面分析 Excel（.xlsx、.xls）和 CSV 文件
• 功能：
  • 自动检测和解析数据类型
  • 对数值列进行统计分析
  • 使用 Chart.js 创建交互式可视化图表
  • 使用 Gemini Flash 2 获取 AI 驱动的洞察
  • 生成包含交互式图表的详细 HTML 报告
  • 通过邮件直接发送分析结果
  • 支持基础和详细分析模式
  • 可自定义输出目录
  • 支持大型数据集
  • 自动检测异常值
  • 对数值列进行相关性分析

2. 研究与邮件发送系统（send-email）

• 生成并发送专业研究论文
• 功能：
  • AI 驱动的研究论文生成
  • 自动通过邮件发送分析结果
  • 支持多种内容类型：
    • 研究论文
    • 技术报告
    • 数据分析摘要
    • 商业智能报告
  • 生成专业的邮件主题
  • 支持 HTML 和纯文本内容
  • 支持可内嵌显示的图片附件
  • 安全的 SMTP 身份验证
  • 全面的错误处理和状态报告
  • 专业的邮件格式
  • 消息发送跟踪
  • 可自定义邮件模板

3. 研究与分析生成器（generate-thinking）

• 高级研究与分析内容生成
• 功能：
  • 研究论文生成
  • 技术文档撰写
  • 数据分析摘要
  • 商业智能报告
  • 保存带时间戳的响应
  • 可自定义输出目录
  • 通过邮件直接发送生成的内容
  • 创建专业内容

📊 快速开始

前提条件

• Node.js（v16 或更高版本）
• TypeScript
• Claude Desktop
• Google Gemini API 密钥
• SMTP 邮件账户（用于邮件功能）

安装

1. 克隆并设置：

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

2. 创建 .env 文件：

GEMINI_API_KEY=your_api_key_here
[email protected]
NODEMAILER_PASSWORD=your_app_password_here

3. 构建项目：

npm run build

Claude Desktop 配置

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": "[email protected]",
        "NODEMAILER_PASSWORD": "your_app_password_here"
      }
    }
  }
}

2. 重启 Claude Desktop

📊 使用工具

使用 EDA 和 AI 进行数据分析

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

使用 AI 生成主题并发送邮件

{
  "name": "send-email",
  "arguments": {
    "to": "[email protected]",
    "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..."
      }
    ]
  }
}

生成思考内容

{
  "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-node 在开发模式下运行

环境变量

• GEMINI_API_KEY：你的 Google Gemini API 密钥
• NODEMAILER_EMAIL：用于发送邮件的邮箱地址
• NODEMAILER_PASSWORD：邮箱应用专用密码（Gmail 用户请使用应用专用密码）

🔒 安全说明

• 安全地保存 API 密钥
• 不要分享 .env 文件
• Gmail 用户请使用应用专用密码，而不是主账户密码
• 谨慎处理通过系统发送的邮件内容
• 邮件示例中切勿包含敏感或个人信息

🐛 故障排除

常见问题

1. API 密钥错误

   • 确认 .env 文件存在
   • 检查 API 密钥是否有效
   • 确保已正确加载环境变量

2. Claude Desktop 连接问题

   • 确认 config.json 语法正确
   • 检查配置中的文件路径
   • 重启 Claude Desktop

3. 邮件发送问题

   • 检查 NODEMAILER_EMAIL 和 NODEMAILER_PASSWORD 是否设置正确
   • 对于 Gmail，请确保已创建应用专用密码
   • 对于非 Gmail 服务商，请确认已启用允许访问安全性较低的应用
   • 检查收件人电子邮件地址格式

4. 数据分析问题

   • 确保文件格式受支持（.xlsx、.xls、.csv）
   • 检查文件编码（建议使用 UTF-8）
   • 确认文件大小未超出限制
   • 确保数值列格式正确

调试模式

在 .env 文件中添加 DEBUG=true 以启用详细日志：

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
}

👨‍💻 作者

Falah G. Salieh
📍 伊拉克巴格达
📅 2025

🤝 贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 推送到该分支
5. 创建 Pull Request

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件