Gemini Data Analysis Research MCP Server

🚀 GEMINI 数据分析平台

GEMINI 数据分析平台提供了丰富的功能，涵盖数据分析、邮件发送和深度思考生成等多个方面，能够帮助用户高效地处理数据、生成邮件以及进行复杂问题的分析。

🚀 快速开始

安装与运行

1. 克隆仓库

   git clone your_repository.git
   

2. 安装依赖

   npm install
   

3. 启动服务

   npm run start
   

✨ 主要特性

1. Gemini 数据分析工具

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

2. 研究与邮件发送系统

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

3. 思考生成器工具

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

💻 使用示例

基础用法

数据分析工具接口定义

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

⚠️ 重要提示

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