项目介绍

GEMINI 数据分析平台

功能模块

1. Gemini 数据分析工具

• 功能描述: 提供强大的数据分析和报告生成能力，支持多种数据文件格式。
• 支持文件类型: .xlsx, .xls, .csv

2. 研究与邮件发送系统

• 邮件发送功能: 支持基于Gemini AI的智能邮件主题生成、文本内容撰写及HTML格式邮件制作。
• 附件管理: 允许添加和嵌入图片到邮件中。

3. 思考生成器工具

• AI驱动思考: 利用Gemini模型进行复杂问题分析，输出深度思考过程文档。

快速开始指南

安装与运行

1. 克隆仓库

   git clone your_repository.git
   

2. 安装依赖

   npm install
   

3. 启动服务

   npm run start
   

使用说明

数据分析工具接口定义

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;       // 可选输出目录
}

输出结构

数据分析模块输出示例

• 文件名: report_[日期时间].html
• 位置: ./output/reports/

思考生成器模块输出示例

• 文件名: gemini_thinking_[日期时间].txt
• 位置: ./output/thinking/

开发信息

可用脚本命令

1. npm run build: 将 TypeScript 代码编译为 JavaScript
2. npm run start: 启动 MCP 服务
3. npm run dev: 在开发模式下运行（使用 ts-node）

环境变量配置

• GEMINI_API_KEY: 您的 Google Gemini API 密钥
• NODEMAILER_EMAIL: 您的电子邮件地址
• NODEMAILER_PASSWORD: 您的电子邮箱应用密码

安全注意事项

1. API密钥管理: 请确保您的 API 密钥安全，避免泄露。
2. 环境文件保护: 切勿分享包含敏感信息的 .env 文件。
3. Gmail设置: 使用 Google 账户时，请使用应用密码而非主密码。

故障排除

常见问题

1. API 密钥错误

   • 确认 .env 文件存在且配置正确
   • 验证密钥的有效性
   • 检查环境变量是否加载成功

2. Claude Desktop 连接问题

   • 检查 config.json 文件语法是否正确
   • 确认文件路径无误
   • 重启 Claude Desktop 应用程序

3. 邮件发送失败

   • 核对电子邮件地址格式是否正确
   • 确保网络连接正常
   • 检查 SMTP 配置参数是否准确

联系方式

• 开发者邮箱: your.email@example.com
• 项目仓库链接: https://github.com/yourusername/yourrepository

注意: 使用本平台前，请仔细阅读并遵守相关法律法规及服务条款。