Gemini Data Analysis & Research

🚀 天秤數據 Gemini 數據分析與研究 MCP 服務器

天秤數據 Gemini 數據分析與研究 MCP 服務器 是一個集成化平臺，專為處理和分析 Gemini 數據而設計。它基於 Node.js 和 TypeScript 開發，支持多種數據分析任務，通過靈活接口實現高效的數據處理。

🚀 快速開始

安裝與配置

1. 克隆代碼倉庫到本地。
2. 創建 .env 文件，設置以下環境變量：
   • GEMINI_API_KEY：天秤數據 API 密鑰
   • NODEMAILER_EMAIL：郵件發送者郵箱地址
   • NODEMAILER_PASSWORD：郵箱應用密碼

啟動服務

運行命令啟動 MCP 服務器：

npm run start

✨ 主要特性

1. 數據分析工具

• 文件解析與數據提取：支持 .xlsx、.xls 和 .csv 文件格式。
• 基礎統計分析：提供基本的數據彙總和統計功能。
• 高級分析功能：包括數據可視化和深度數據分析。

2. 郵件發送工具

• 郵件內容生成：使用 Gemini AI 模型自動生成郵件主題和正文。
• 多版本支持：支持 plain text 和 HTML 格式的郵件內容。
• 附件管理：允許添加和管理圖片附件。

3. 思考生成工具

• 分析提示處理：解析用戶的分析請求並生成相應輸出。
• 結果存儲：將思考過程和結果保存至指定目錄。

💻 使用示例

數據分析工具接口

interface 分析數據參數 {
  fileData: string;         // Base64 編碼文件內容
  fileName: string;         // 文件名（必須為 .xlsx、.xls 或 .csv 格式）
  analysisType: 'basic' | 'detailed';  // 分析類型
  outputDir?: string;      // 可選輸出目錄
}

郵件發送工具接口

interface 發送郵件參數 {
  to: string;              // 收件人郵箱地址
  subjectPrompt: string;   // 提示 Gemini 模型生成郵件主題
  text: string;            // 純文本版本的郵件內容
  html?: string;           // HTML 格式的郵件內容（可選）
  images?: {               // 可選圖片附件
    name: string;          // 圖片文件名
    data: string;          // Base64 編碼的圖片數據
  }[];
}

思考生成工具接口

interface 生成思考參數 {
  prompt: string;           // 分析提示
  outputDir?: string;       // 可選輸出目錄
}

📚 詳細文檔

輸出結構

數據分析工具輸出

• data/：存儲數據解析和統計結果。
• thinking/：保存 Gemini 的思考過程記錄。
• emails/：記錄郵件發送日誌。

開發信息

腳本命令

• npm run build：將 TypeScript 代碼編譯為 JavaScript。
• npm run start：啟動 MCP 服務器。
• npm run dev：以開發模式運行，支持熱重載。

環境變量配置

• GEMINI_API_KEY：天秤數據 API 密鑰
• NODEMAILER_EMAIL：用於發送郵件的郵箱地址
• NODEMAILER_PASSWORD：郵箱應用密碼（使用 Gmail 時，請使用應用專用密碼）

安全注意事項

1. 密鑰管理：
   • 避免在代碼中明文存儲 API 密鑰。
   • 使用環境變量或加密配置文件來管理密鑰。
2. 權限控制：
   • 確保服務器端口和資源訪問權限適當設置。
   • 定期審查和更新訪問策略。
3. 日誌監控：
   • 啟用詳細的日誌記錄功能。
   • 定期審計日誌文件，識別異常行為。

📄 許可證

該軟件遵循 MIT 開源協議。詳細許可條款請參考項目倉庫中的 LICENSE 文件。

此文檔為天秤數據 Gemini 數據分析與研究 MCP 服務器的使用指南，旨在幫助開發者快速上手和集成相關功能模塊。