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 [你的仓库 URL]
cd gemini-data-analysis-email-generator
npm install

2. 创建 .env 文件：

GEMINI_API_KEY=你的_api_密钥_在这里
NODEMAILER_EMAIL=你的.email@gmail.com
NODEMAILER_PASSWORD=你的_app_密码_在这里

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": "你的_api_密钥_在这里",
        "NODEMAILER_EMAIL": "你的.email@gmail.com",
        "NODEMAILER_PASSWORD": "你的_app_密码_在这里"
      }
    }
  }
}

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": "recipient@example.com",
    "subjectPrompt": "为商业报告创建专业的标题",
    "text": "你好！这是我们电子邮件的纯文本版本。",
    "html": "<h1>你好！</h1><p>这是我们电子邮件的<b>HTML</b>版本。</p>",
    "images": [
      {
        "name": "chart.png",
        "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      }
    ]
  }
}

思维生成

{
  "name": "generate-thinking",
  "arguments": {
    "prompt": "分析 2024 年第一季度的市场趋势",
    "outputDir": "./thinking_output"
  }
}

📁 输出结构

output/
├── analysis/
│   ├── plots/
│   │   ├── column1_histogram_[时间戳].html
│   │   └── column2_histogram_[时间戳].html
│   ├── analysis_[时间戳].txt
│   └── report_[时间戳].html
├── thinking/
│   └── gemini_thinking_[时间戳].txt
└── emails/
    └── email_log_[时间戳].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 语法
   • 检查 config 中的文件路径
   • 重启 Claude Desktop

3. 电子邮件发送问题

   • 检查 NODEMAILER_EMAIL 和 NODEMAILER_PASSWORD 是否设置正确
   • 对于 Gmail，请确保你已创建应用密码
   • 验证是否为非 Gmail 提供商启用了安全性较低的应用访问权限
   • 检查收件人电子邮件地址格式

4. 数据分析问题

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

调试模式

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

GEMINI_API_KEY=你的_密钥_在这里
DEBUG=true

📚 API 参考

数据分析工具

interface AnalyzeDataParams {
  fileData: string;         // Base64 编码的文件内容
  fileName: string;         // 文件名（必须是 .xlsx、.xls 或 .csv）
  analysisType: 'basic' | 'detailed';  // 分析类型
  outputDir?: string;      // 可选的输出目录
}

电子邮件发送工具

interface SendEmailParams {
  to: string;              // 收件人电子邮件地址
  subjectPrompt: string;   // Gemini 生成电子邮件主题的提示
  text: string;            // 电子邮件的纯文本版本
  html?: string;           // 电子邮件的 HTML 版本（可选）
  images?: {               // 要附加的可选图像
    name: string;          // 图像文件名
    data: string;          // Base64 编码的图像数据
  }[];
}

思维生成工具

interface GenerateThinkingParams {
  prompt: string;           // 分析提示
  outputDir?: string;       // 可选的输出目录
}

👨‍💻 作者

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

🤝 贡献

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

📄 许可证

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