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

⚠️ 重要提示

使用本平臺前，請仔細閱讀並遵守相關法律法規及服務條款。