Falahgs Gemini Data Analysis Research MCP Server

🚀 金星數據分析服務器

本項目基於Google Gemini模型構建，提供高效的數據分析和任務自動化服務。詳細介紹了服務器架構、功能模塊以及使用方法，助力用戶輕鬆實現數據處理與分析。

🚀 快速開始

安裝步驟

1. 克隆代碼倉庫
2. 安裝依賴包：npm install
3. 創建配置文件.env

環境變量設置

GEMINI_API_KEY=你的密鑰
NODEMAILER_EMAIL=你的郵箱
NODEMAILER_PASSWORD=應用密碼

✨ 主要特性

數據分析工具

• 文件解析：支持.xlsx、.xls、.csv格式
• 基礎分析：
  • 描述性統計
  • 數據分佈分析
• 深度分析：
  • 數據建模
  • 預測分析
• 可視化輸出：
  • 動態圖表
  • 報告生成

自動化處理工具

• 任務調度
• 工作流管理
• 日誌跟蹤

智能生成模塊

• 基於Gemini模型的內容生成
• 多語言支持
• 文本摘要和翻譯功能

💻 使用示例

數據分析工具接口

interface AnalyzeDataParams {
  fileData: string;         // Base64文件內容
  fileName: string;         // 文件名（僅支持.xlsx、.xls、.csv）
  analysisType: 'basic' | 'detailed';  // 分析類型
  outputDir?: string;      // 可選輸出目錄
}

自動化工具接口

interface AutomationParams {
  taskName: string;          // 任務名稱
  parameters?: Record<string, any>;   // 附加參數
}

📚 詳細文檔

輸出結構

/output/
├── reports/         # 分析報告
│   ├── basic_分析時間.html
│   └── detailed_分析時間.html
├── logs/
│   ├── task_日誌時間.log
│   └── error_日誌時間.log
└── models/
    └── 模型文件名.json

開發信息

可用腳本命令

• npm run build：編譯項目
• npm run start：啟動服務
• npm run dev：開發模式

🔧 技術細節

安全注意事項

• 保護好API密鑰
• 避免洩露環境變量
• 使用安全的通信協議
• 定期更新依賴庫

故障排除

常見問題及解決方法：

1. API連接失敗
   • 檢查網絡狀態
   • 確認密鑰有效
2. 任務執行異常
   • 查看日誌文件
   • 檢查參數配置
3. 數據解析錯誤
   • 驗證文件格式
   • 確保數據完整性

API參考文檔

詳細接口定義請參閱項目文檔。

貢獻指南

歡迎貢獻代碼：

1. 叉取倉庫
2. 創建功能分支
3. 提交修改
4. 發起合併請求

📄 許可證

本項目採用MIT許可證，具體條款詳見LICENSE文件。